Ошибки, лимиты и пагинация

Код HTTP показывает, что делать дальше: исправить запрос, проверить доступ, снизить частоту или повторить попытку позже. Описание ошибки приходит в JSON.

#Формат ошибки

Обычная ошибка содержит поле detail:

{
  "detail": "Missing API key. Provide X-API-Key header or Authorization: Bearer <key>"
}

Ошибка параметров содержит список с местом и причиной:

{
  "detail": [
    {
      "loc": ["query", "granularity"],
      "msg": "value is not a valid enumeration member; permitted: 'day', '3h'",
      "type": "type_error.enum"
    }
  ]
}

#Коды состояния

• 200 OK: запрос выполнен.
• 400 Bad Request: запрос нельзя обработать с переданными данными.
• 401 Unauthorized: API-ключ отсутствует или не прошёл проверку.
• 403 Forbidden: ключ не имеет доступа к рынку.
• 404 Not Found: ресурс не найден.
• 422 Unprocessable Entity: параметр имеет неверный тип, значение или диапазон.
• 429 Too Many Requests: превышён лимит запросов.
• 503 Service Unavailable: сервис временно недоступен.

#Лимиты и квоты

Для тарифа Pro действуют следующие ограничения:

• до 1 000 000 запросов в месяц;
• до 500 запросов в минуту;
• до 10 API-ключей в проекте.

#Постраничная выдача

Большинство списков принимает limit для размера страницы и offset для числа пропущенных элементов. Точные границы указаны у каждого метода.

curl "https://dstrends.com/api/v1/entities?region=us&limit=50&offset=50" \
  -H "X-API-Key: $DTR_API_KEY"

Лента v2 также поддерживает курсор. Используйте его для последовательной выгрузки новых элементов без повторов.