Хронологический журнал изменений, улучшений и новых функций Developer API akousa.net.
Счётчики дневной квоты сбрасываются без исключений в начале каждых суток UTC. Каждый ответ содержит X-RateLimit-Limit, X-RateLimit-Remaining и X-RateLimit-Reset, поэтому клиент, исчерпавший квоту, может запланировать повтор по метке времени сброса вместо опроса API.
AkousaX-RateLimit-Limit: 50
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1786060800Версионированные конечные точки теперь отправляют Access-Control-Expose-Headers, поэтому код в браузере может читать X-API-Version, Deprecation, Sunset и Link. Эти заголовки всегда присутствовали в ответе, но оставались невидимыми для кросс-доменного JavaScript.
Access-Control-Expose-Headers: X-API-Version, Deprecation, Sunset, LinkИзменения в поверхности v1 только дополняющие: поля не удаляются и не переименовываются, а несовместимое изменение выходит новым путём версии и заранее объявляется заголовками Deprecation и Sunset. Поскольку новые поля могут появиться в любой момент, клиентам следует игнорировать незнакомые поля. Вместе с этим договором X-API-Version перешёл на 1.1.0.
X-API-Version: 1.1.0Отдельные ключи для разных продуктов объединены в один ключ ak_. При создании вы выбираете области, доступные ключу — tools, data, analytics, analyze, news и workflow — а вызовы конечных точек вне этих областей отклоняются. Ключи, созданные до изменения, сохраняют прежний доступ.
POST /api/v1/keys
{
"name": "production",
"scopes": ["tools", "data", "news"]
}Конечные точки в /api/v1/data/* отвечают единой оболочкой: полезная нагрузка в data, детали доставки в meta — какая служба ответила, исходный источник, пришёл ли ответ из кеша и сколько времени занял. Один и тот же код разбора работает для всех наборов данных.
{
"data": [ ... ],
"meta": {
"service": "earthquakes",
"source": "usgs",
"cached": true,
"executionMs": 34
}
}API версионируется через путь URL. Текущая версия — v1. Несовместимые изменения приведут к созданию новой версии.
POST /api/v1/sandboxPOST /api/v1/tools/{slug}Deprecation: @1772323200
Link: </docs/api/changelog#changelog-deprecationHeaders>; rel="deprecation", </api/v1/tools/{slug}>; rel="successor-version"