История изменений
Датированные записи на человеческом языке о каждом изменении публичной поверхности API.
Каждое изменение публичной поверхности фиксируется здесь, новые записи сверху. Аддитивные изменения выходят без уведомления; всё остальное объявляется со сроком вывода из эксплуатации, описанным в разделе Версионирование и вывод из эксплуатации.
Если вы интегрируетесь с этим API, эта страница — самый дешёвый способ узнать об изменении раньше, чем о нём расскажут ваши логи.
2026-09-06 — Публичный API становится контрактом с явным включением
Добавлено. Этот сайт документации и генерируемый
справочник эндпоинтов, отрисованный из опубликованного документа
OpenAPI. Сам документ доступен по адресу
/openapi/public-openapi.yaml, если вам удобнее
сгенерировать клиент, чем читать страницу.
Изменено — граница теперь объявляется, а не вычитается. Эндпоинт входит в
публичный API только если сам себя таковым объявил. Раньше поверхность, доступная
токену fgd_live_, задавалась вручную поддерживаемым списком префиксов на
исключение, что отвечало на вопрос «что кто-то не забыл запретить», а не «что
должно быть достижимо» — и два списка, пытавшиеся на него ответить, расходились
друг с другом и с документацией.
Для вас как интегратора это означает: справочник теперь и есть поверхность. Задокументировано ровно то, что доступно токену, потому что и то и другое генерируется из одного объявления, а не выводится порознь. Маршрут, которого нет в справочнике, отвечает 403, а не работает незадокументированным.
Добавлено. Заголовки ответа Deprecation (RFC 9745) и Sunset (RFC 8594) на
устаревших операциях и опубликованный срок вывода из эксплуатации — шесть месяцев.
См. Версионирование и вывод из эксплуатации:
у этих двух заголовков разный синтаксис значений, и это стоит прочитать до того,
как вы начнёте их разбирать.
Изменено. Управление API-токенами внутренне переехало между сервисами.
Публичный путь /v1/api-tokens не изменился, как и формат токена fgd_live_ и все
существующие токены — эта запись здесь потому, что переезд виден в нашей
документации и логах, а не потому, что изменилось что-то, с чем вы интегрировались.
Выведено из употребления. X-Foxguide-Signature — вариант подписи вебхука
только по телу, без метки времени. Каноническая схема — X-Webhook-Signature по
строке ${timestamp}.${сырое тело}, описанная в разделе
Вебхуки. В продакшне retired-заголовок никем не отправлялся
и не принимался.