API документация

Быстрый старт

Базовый endpoint: POST /api/v1/lookups. API принимает только IMEI из 15 цифр с корректной контрольной суммой.

1. Авторизация

Передавайте ключ в заголовке Authorization: Bearer YOUR_API_KEY. Полный ключ показывается один раз при создании в личном кабинете.

2. Запрос

curl -X POST https://YOUR_DOMAIN/api/v1/lookups \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: your-unique-request-id' \
  -d '{"imei":"<15-digit IMEI>","include":["identity"]}'

3. Ответ

known — подтверждённые данные из базы. unknown — данных пока нет, сервис запускает поиск информации об устройстве. Внешний поиск никогда не задерживает ваш запрос.

{
  "request_id": "uuid",
  "schema_version": "1.0",
  "status": "unknown",
  "device": null,
  "research": "queued",
  "billing": {
    "currency": "USD",
    "amount": "<current unknown price>"
  }
}

Пример показывает структуру, а не найденное устройство. Текущие цены доступны в кабинете.

Группы данных

identityhardwaredisplayconnectivitybatteryphysicalsoftwaremedialifecycle

По умолчанию запрашивается identity. Неизвестные значения возвращаются как null. Конфигурации памяти — списком, если точный вариант не установлен.

Batch: несколько IMEI

До 50 номеров за запрос. Передайте массив imeis вместо imei. Дубликаты проверяются один раз. Ответ содержит results с результатом или ошибкой каждого номера и общую стоимость billing.amount. Ошибки отдельных номеров возвращаются внутри batch-ответа с HTTP 200. Успешные проверки оплачиваются отдельно. Для повтора используйте неизменный список и тот же Idempotency-Key (до 100 символов).

{
  "imeis": [
    "490154203237518",
    "356938035643809"
  ],
  "include": [
    "identity"
  ]
}

Повторы и списания

Повтор с тем же Idempotency-Key возвращает сохранённый ответ без нового списания. Для получения свежих данных используйте новый ключ. Тот же ключ с другим запросом возвращает 409.

Ошибки

HTTP	Описание
`400`	Невалидный ввод
`401`	Отсутствующий или неверный ключ
`402`	Недостаточно средств
`403`	Недостаточно прав
`409`	Конфликт ключа идемпотентности
`429`	Превышен лимит
`5xx`	Техническая ошибка

Ограничения текущего preview

База начинает наполняться с нуля. Сервис работает в тестовом режиме. Пополнение баланса пока недоступно. При приватном доступе к сайту серверным клиентам требуется также сервисная авторизация площадки; одного API-ключа недостаточно. Выгрузки базы появятся позже.

Первая интеграция.Всё по делу.