API НССО

Документация по работе с API НССО

Таймаут: Установите таймаут ожидания минимум 120–400 секунд.

Эндпоинт

GET https://ru-api.ru/api/nsso?type={type}&token={key}&...

Аутентификация

Получите персональный ключ API (32 символа) и передавайте его в параметре token с каждым запросом.

Типы запросов

type	Описание	Параметры
`check`	Проверка НССО Проверка организации в реестре НССО по ИНН	`inn`*

* — обязательный параметр. Все запросы также требуют параметр token.

Формат ответа

Успех:

{
  "status": 200,
  "source": "nsso",
  "type": "тип_запроса",
  "num": 3,
  "rez": [ ... ],
  "inquiry": {
    "price": 1.50,
    "speed": "5.2 сек",
    "attempts": 1,
    "balance": 498.50,
    "cached": false
  }
}

Ошибка:

{"error": "503", "message": "TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}

Пример запроса

curl "https://ru-api.ru/api/nsso?type=check&token=ВАШ_ТОКЕН"&inn=...

Коды ошибок

Код	Описание
502	Отсутствует параметр token
503	Токен не зарегистрирован
499	Неверный формат токена
498	Недостаточно средств
500	Отсутствует параметр type
460	Отсутствуют обязательные параметры
404	Источник не найден
456	Превышен лимит одновременных соединений
1	API временно приостановлен