API

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

API registrul.md отдаёт данные о компаниях Республики Молдова. Для доступа нужен API-ключ и активная подписка Business или Agency.

Кому доступно

Создавать ключи и вызывать /api/v1/* могут только аккаунты с активной подпиской Business или Agency. Free и Starter API не включают.

Business — средний лимит (60/min)
Agency — высокий лимит (300/min)

Смотреть тарифы

Создание API-ключа

При активации Business/Agency ключ создаётся автоматически (если активного ещё нет). Допускается только один активный ключ — для ротации отзовите или используйте «Пересоздать». Полный ключ (префикс reg_) показывается один раз.

Управление API-ключом

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

Передайте ключ одним из заголовков (достаточно одного):

Authorization: Bearer reg_…
X-Api-Key: reg_…

Ключи всегда начинаются с reg_. Без валидного ключа запрос отклоняется с 401.

Эндпоинт

Базовый URL: https://registrul.md

GET /api/v1/company/{idno}

Замените {idno} на IDNO компании (только цифры, минимум 10). Ответ включает основные данные, учредителей, администраторов и коды CAEM.

Примеры curl

curl -s \
  -H "Authorization: Bearer reg_YOUR_API_KEY" \
  "https://registrul.md/api/v1/company/1025600022949"

curl -s \
  -H "X-Api-Key: reg_YOUR_API_KEY" \
  "https://registrul.md/api/v1/company/1025600022949"

Пример JSON-ответа

Реальная форма ответа (поля founders / admins / caem зависят от компании):

{
  "idno": "1025600022949",
  "name": "Societatea cu Răspundere Limitată \"FIX MOTORS GO\"",
  "legal_form": "S.R.L.",
  "status": "activa",
  "reg_date": "2025-07-04",
  "address": "MD-2002, CHIȘINĂU BOTANICA, mun. Chișinău, Plaiului, 128, ap.(of.) 2",
  "region": "110",
  "capital": "…",
  "vat_payer": false,
  "caem_main": "5320",
  "url": "https://registrul.md/companie/…",
  "founders": [
    { "name": "…", "share": "100,00%", "type": "persoana_fizica" }
  ],
  "admins": ["…"],
  "caem": [
    { "code": "5320", "label": "…", "main": true }
  ]
}

Лимиты запросов

Лимиты считаются на API-ключ в скользящем окне 60 секунд. Фактический tier берётся из активного плана (не из значения на ключе).

План	Tier	Лимит
Business	medium	60 запросов / минуту
Agency	high	300 запросов / минуту

При успехе ответ включает X-RateLimit-Limit и X-RateLimit-Tier. При 429: Retry-After: 60.

Коды ошибок

HTTP	error	Значение
401	missing_or_invalid_api_key	Ключ отсутствует, недействителен или отозван
403	no_active_api_plan	Нет активного API-плана (Business/Agency)
400	invalid_idno	Некорректный IDNO (слишком короткий)
404	not_found	Компания не найдена
429	rate_limited	Превышен лимит — подождите и повторите

Безопасность

Полный ключ показывается один раз при создании — скопируйте сразу.
Сразу отзовите или пересоздайте скомпрометированный ключ в /cont/api.
Не коммитьте ключи в git, не вставляйте в публичный фронтенд и не делитесь в чатах.
Публичный виджет (/api/widget/…) отдельный и не использует API-ключи — не путайте с /api/v1/.