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

Подразделения

Получение подразделений компании.

Возвращает информацию о подразделениях указанной компании.

Эндпоинт

GET /api/v1/companies/:company_id/department

Параметры

ПараметрТипГдеОписание
company_idintegerpathУникальный идентификатор компании.

Примеры кода

Получение подразделений

import requests

url = 'https://statsnet.co/api/v1/companies/12345/department'
headers = {
  'Authorization': 'Bearer sk_live_YOUR_KEY',
  'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers).json()
print(response)

Ответ

Успешный ответ

{
  "identifier": "400500600",
  "jurisdiction": "kz",
  "departments": [
    "Департамент государственных доходов по г. Алматы",
    "Департамент экологии"
  ]
}

Если запись о подразделениях для компании отсутствует, возвращается пустой объект со статусом 200 OK:

Пустой ответ

{
  "identifier": "",
  "jurisdiction": "",
  "departments": null
}

Обработка ошибок

Ответ с ошибкой (403)

{
  "status": 403,
  "message": "access denied"
}

Требуется оплата (402)

{
  "status": 402,
  "message": "payment required"
}

Квота исчерпана (429)

{
  "status": 429,
  "message": "quota exhausted"
}