Skip to main content

Отримати ідентифікацію співробітника GET /api/external/company/employee/identification

REQUEST

URL

Метод запиту

POSTGET

URL запиту

/api/external/company/employee/identification

URL параметри

companyCode (обов’язково) - код Компанії;

employeeIpn (обов’язково) - ІПН/РНОКПП співробітника.

Authorization

Auth type

 API key

Key / Value

 x-system-id - токен, отриманий при підключенні

Headers

  

Content-Type

application/json
RESPONSE

У тілі відповіді передаються статус 200 та об'єкт з даними співробітника.

Опис параметрів відповіді:

Поле Тип Опис
info object Об'єкт ESSUserIdentification.
data string Base64 підпису ідентифікації. Повертається лише якщо info.complete == YES.

Якщо ідентифікація не завершена, поле data не повертається.

JSON  приклад відповіді:

{
  "info": {
    "type": "SIGN",
    "complete": "YES",
    "fullName": "Іваненко Іван Іванович",
    "fullNameEN": "IVANENKO IVAN",
    "ipn": "3148615913",
    "unzr": "19900101-12345",
    "state": "Київська",
    "city": "Київ",
    "address": "вул. Тестова, 1",
    "publicKey": "01 02 03 ...",
    "validTo": 1780272000,
    "sign": null
  },
  "data": "base64 identification sign container"
}

 

CURL
curl -X GET 'https://host/api/external/company/employee/identification?...' \
  -H 'x-system-id: 019eb581-307b-7562-8a1f-20227511e898'

 

Помилки 
HTTP type Опис
400 employee_not_found Співробітник не знайдений.
400 employee_identification_not_found Ідентифікація співробітника не знайдена.
400 employee_identification_sign_not_found Ідентифікація завершена, але файл підпису не знайдено.
403 company_access_denied Немає доступу до company.
Back to top