Ключ и лимиты
Ключ выдаёт владелец сервиса вручную после заявки. Передавайте его в заголовке Authorization: Bearer <ключ>. Сохраните секрет при выдаче: повторно получить его нельзя. Не публикуйте его в браузерном коде. Доступ предназначен для запросов с вашего сервера; межсайтовый доступ из браузера не открыт.
Лимиты считаются на ключ: 20 HTTP-запросов в минуту и по умолчанию 500 за интервал 24 часа. Суточный интервал начинается с первого запроса после сброса счётчика. Один пакет — один запрос. При ответе 429 ориентируйтесь на заголовок Retry-After. Условия использования — в пользовательском соглашении.
Формат и ошибки
Все ответы — JSON в UTF-8 с полем version: "1". Даты документов: ДД.ММ.ГГГГ; время checked_at: ISO 8601 в UTC. Оно относится к получению данных из источника, а не к повторному показу кэша. Для старой записи без времени — null. У каждой записи есть source и official_url.
- 200 — ответ получен; проверяйте поле
state. - 401 — ключ отсутствует, неверен или отозван.
- 404 — точное совпадение номера не найдено.
- 422 — неверный номер, ИНН, параметры или пакет больше 25 номеров.
- 429 — лимит ключа исчерпан.
- 503 — первоисточник временно недоступен; это не означает отсутствия документа.
Один документ
GET /api/v1/documents/{number}. Передавайте полный номер с URL-кодированием; слэш года оставляйте разделителем пути. Точная проверка использует общий кэш на 6 часов.
curl --path-as-is \
-H 'Authorization: Bearer <ключ>' \
'https://rostest.spb.ru/api/v1/documents/%D0%95%D0%90%D0%AD%D0%A1%20N%20RU%20%D0%94-TE.CT.00001/26'Пример схемы успешного ответа (условные данные):
{"version":"1","state":"ok","number":"ЕАЭС N RU Д-TE.CT.00001/26",
"data":{"number":"ЕАЭС N RU Д-TE.CT.00001/26","type":"Декларация о соответствии",
"status":"valid","status_label":"Действует","date_issue":"01.01.2026",
"date_expiry":"01.01.2031","applicant":"Тестовая организация","applicant_inn":"",
"manufacturer":"Тестовый изготовитель","product":"Тестовый товар",
"technical_regulations":[],"official_url":"https://pub.fsa.gov.ru/",
"source":"fsa","checked_at":"2026-09-27T08:00:00+00:00"}}Пакет до 25 номеров
POST /api/v1/documents/batch. Передайте JSON-массив numbers. Ответ сохраняет порядок и все номера, включая дубли. Проверяйте state каждого элемента. Для нескольких холодных запросов медленный реестр может исчерпать бюджет времени: оставшиеся элементы получат unavailable с пояснением, их нужно повторить отдельно. Прогретые записи берутся из кэша.
curl -X POST -H 'Authorization: Bearer <ключ>' \
-H 'Content-Type: application/json' \
-d '{"numbers":["ЕАЭС N RU Д-TE.CT.00001/26"]}' \
'https://rostest.spb.ru/api/v1/documents/batch'
{"version":"1","state":"ok","items":[
{"state":"not_found","number":"Условный номер","data":null,
"message":"Точное совпадение номера в реестре не найдено."}]}Документы компании
GET /api/v1/companies/{inn}/documents?status=all&page=1. ИНН проходит проверку контрольной суммы. Статус: all, valid, attention, invalid. По 20 записей на странице; has_more сообщает о следующей. Выборка ограничена 300 декларациями и 300 сертификатами, сводка не является полным числом документов в реестре. truncated указывает возможное ограничение.
curl -H 'Authorization: Bearer <ключ>' \
'https://rostest.spb.ru/api/v1/companies/7721546864/documents?status=valid&page=1'
{"version":"1","state":"ok","inn":"7721546864","company_name":"Условная компания",
"page":1,"has_more":false,"summary":{"total":0,"valid":0,"attention":0,
"invalid":0,"expiring_soon":0},"truncated":false,
"scope":"До 300 деклараций и 300 сертификатов; сводка относится к полученной выборке.","items":[]}Аккредитация
GET /api/v1/accreditation?q=…. Номер аттестата, название или ИНН от 3 символов. До 10 записей РАЛ и до 10 последних документов первого органа. Недоступность последних документов отдельно отмечена в recent_unavailable.
curl -H 'Authorization: Bearer <ключ>' \
'https://rostest.spb.ru/api/v1/accreditation?q=RA.RU.710374'
{"version":"1","state":"ok","items":[{"reg_number":"RA.RU.710374",
"status_bucket":"active","status_label":"Аккредитация действует",
"official_url":"https://pub.fsa.gov.ru/ral/","source":"fsa_ral",
"checked_at":"2026-09-27T08:00:00+00:00"}],"message":null,
"recent_unavailable":false,"recent_documents":[]}Строки в примерах иллюстрируют формат и не подтверждают наличие или статус реального документа. Запросите ключ через кнопку выше, чтобы проверить свои данные.