Метод `account` — ключи и доступ клиента

Для чего нужен метод

Метод account показывает, что входит в доступ клиента. По любому своему ключу клиент получает данные по всем своим ключам: срок действия, сколько дней осталось, доступные виды спорта и языки, когда ключ использовался последний раз и сколько запросов по нему было за 7 дней.

По списку языков ключа удобно строить переключатель языков на сайте: в нём только языки, которые входят в ключ и доступны в линии.

Запрос

GET https://YOUR_API_DOMAIN/v1/account

API-ключ необходимо передавать в HTTP-заголовке:

Package: YOUR_API_KEY

Параметров нет, язык в пути не указывается.

Пример ответа

{
  "status": 1,
  "page": "/v1/account",
  "body": {
    "client": {
      "public_id": "f47ad380-39e2-4549-ac76-aa422df628ea",
      "name": "Example"
    },
    "your_ip": "203.0.113.7",
    "keys": [
      {
        "key": "…c55f",
        "current": true,
        "type": "test",
        "status": "active",
        "label": "демо 12 дней",
        "starts_at": null,
        "expires_at": "2026-11-03T14:34:23.479Z",
        "days_left": 30,
        "active": true,
        "sports": "all",
        "languages": ["ru", "en"],
        "last_used_at": "2026-10-04T15:20:07.843Z",
        "access_mode": "enforce",
        "allowed_ips": ["203.0.113.7", "198.51.100.0/24"],
        "allowed_domains": ["example.com", "*.example.com"],
        "usage_7d": [
          { "date": "2026-09-28", "requests": 0 },
          { "date": "2026-09-29", "requests": 0 },
          { "date": "2026-09-30", "requests": 0 },
          { "date": "2026-10-01", "requests": 0 },
          { "date": "2026-10-02", "requests": 0 },
          { "date": "2026-10-03", "requests": 0 },
          { "date": "2026-10-04", "requests": 7 }
        ]
      }
    ]
  }
}

Поля ответа

Поле	Тип	Описание
`client.public_id`	string	Идентификатор клиента
`client.name`	string	Название клиента
`your_ip`	string	IP-адрес, с которого пришёл этот запрос. Его нужно сообщить для ограничения доступа по IP
`keys[].key`	string	Последние 4 символа ключа (ключ целиком не возвращается)
`keys[].current`	bool	`true` — ключ, с которым выполнен запрос
`keys[].type`	string	`test` — тестовый, `prod` — рабочий
`keys[].status`	string	`active` — действует, `paused` — приостановлен
`keys[].label`	string \| null	Метка ключа («сайт 1», «зеркало»)
`keys[].starts_at`	string \| null	Начало действия (ISO 8601, UTC); `null` — действует с выдачи
`keys[].expires_at`	string	Окончание действия (ISO 8601, UTC)
`keys[].days_left`	int	Сколько дней осталось, с округлением вверх; `0` — срок истёк
`keys[].active`	bool	Ключ сейчас работает: статус `active`, срок начался и не истёк
`keys[].sports`	string \| int[]	`"all"` — все виды спорта линии, иначе список ID видов спорта
`keys[].languages`	string[]	Языки, доступные по ключу в линии
`keys[].last_used_at`	string \| null	Время последнего запроса по ключу (UTC); `null` — не использовался
`keys[].access_mode`	string	Ограничение доступа: `off` — отовсюду, `monitor` — отовсюду (источники проверяются без отказа), `enforce` — только с разрешённых IP или сайтов
`keys[].allowed_ips`	string[]	Разрешённые IP и подсети (`198.51.100.0/24` — все адреса `198.51.100.0`–`198.51.100.255`)
`keys[].allowed_domains`	string[]	Разрешённые сайты для запросов из браузера: `example.com` — только этот домен, `*.example.com` — все поддомены
`keys[].usage_7d`	object[]	Успешные запросы по дням (UTC) за последние 7 дней, сегодня — последний элемент

Отозванные ключи в ответ не входят. usage_7d учитывает и только что выполненные запросы, last_used_at обновляется раз в минуту.

Заголовок `X-Key-Expires`

Каждый ответ API, не только account, содержит заголовок X-Key-Expires с датой окончания ключа, переданного в запросе:

X-Key-Expires: 2026-11-03T14:34:23.479Z

По нему можно заранее напомнить о продлении, не вызывая account.

Метод account — ключи и доступ клиента