API

Підказка

Всі запити нижче перерахованих API методів сервісу EDIN-Tender 2.0 направляються на адресу: https://edo-v2.edin.ua

Авторизація

Метод

URL запиту

Опис

POST

/api/authorization/hash

Авторизація

GET

/api/auth_check

Перевірка активності сесії

Робота зі ставками

Метод

URL запиту

Опис

POST

/api/v1/tender/lot/bets

Зробити ставку по лоту (Учасник)

DELETE

/api/v1/tender/lot/bets

Видалити ставку по лоту тендера (Організатор)

Робота з тендерами

Метод

URL запиту

Опис

POST

/api/v1/tender/auctions

Створити новий тендер (чернетку)

PATCH

/api/v1/tender/auctions/publish

Опублікувати тендер

GET

/api/v1/tender/auction

Отримати дані тендера (за id)

GET

/api/v1/tender/auctions/drafts

Отримання списку тендерів з «Чернеток»

GET

/api/v1/tender/auctions/my

Отримання списку тендерів з «Мої тендери»

GET

/api/v1/tender/auctions/all

Отримання списку з «Усі тендери»

GET

/api/v1/tender/auction/views

Отримати дані про перегляди тендера (за id)

GET

/api/v1/tender/guest/auctions/all

Отримання списку тендерів для неавторизованого користувача

PATCH

/api/v1/tender/auctions/close

Завершити тендер (Організатор)

POST

/api/v1/tender/auction/access/invite

Запросити компанії взяти участь в тендері (Організатор)

POST

/api/v1/tender/auction/access/request

Подати заявку на участь в закритому аукціоні (Учасник)

GET

/api/v1/tender/auction/access/company/outgoing

Отримати дані по заявкам на участь в закритих аукціонах (Учасник)

PATCH

/api/v1/tender/auction/access/confirm

Схвалити заявку на участь в закритому аукціоні (Організатор)

PATCH

/api/v1/tender/auction/access/reject

Відхилити заявку на участь в закритому аукціоні (Організатор)

Довідники

Метод

URL запиту

Опис

GET

/api/v1/tender/categories

Отримати довідник категорій

GET

/api/v1/tender/currency

Отримати довідник валют

GET

/api/v1/tender/regions

Отримати довідник регіонів

GET

/api/v1/tender/units

Отримати довідник одиниць виміру

Довідник учасників

Метод

URL запиту

Опис

GET

/api/v1/tender/participant_group/list

Отримати список всіх наявних груп учасників

GET

/api/v1/tender/participant_group

Отримати дані групи учасників

POST

/api/v1/tender/participant_group

Створити/Редагувати групу учасників

DELETE

/api/v1/tender/participant_group

Видалити групу учасників


Загальні помилки при роботі з API (всі сервіси EDIN)

Код відповіді

Індекс помилки

Текст помилки

Опис

400

ERR_CMN-1

Parameter(s) [%s] is(are) required

Параметр(и) [%s] є обов’язковим(и)

Помилка виникає, якщо не передати обовязковий url-параметр (наприклад, doc_uuid)

400

ERR_CMN-2

Unknown or unsupported %s [%s]

Непідтримуваний %s [%s]

Помилка виникає, якщо вказаний параметр не підтримується (наприклад, передавати response_type=xml, але доступні тільки - file, base64, bytes)

400

ERR_CMN-3

Parameter [%s] must have format format: [%s]

Параметер [%s] повинен мати формат: [%s]

Помилка виникає, коли клієнт в url параметрі передав значення, в форматі, що не підтимується

400

ERR_CMN-4

Incorrect Content-Type in request, one of [%s] is expected

Некоректний Content-Type. Очікується один з наступних:

400

ERR_CMN-5

Unsupported method [%s]

Непідтримуваний метод [%s]

400

ERR_CMN-6

Expected [%s] file(s) in multipart/form data

Очікується [%s] файл(и)ів у multipart/form data

400

ERR_CMN-7

Request body is empty

Тіло запиту порожнє

400

ERR_CMN-7

Unknown gln: [%s]

Невідомий gln: [%s]

400

ERR_CMN-8

Supported not more [%s] files per request

Підтримується не більше [%s] файлів на запит

400

ERR_CMN-9

Exceeded max file name length

Перевищено максимальну довжину імені файлу

400

ERR_CMN-10

Exceeded max file size - [%s]

Перевищено максимальний розмір файлу - [%s]

400

ERR_CMN-11

Action not available, reason - [%s]

Дія не доступна, причина - [%s]

Помилка виникає в різних випадках, наприклад, коли відправник документа CONDRA хоче її прийняти, але це може зробити тільки отримувач документа

400

ERR_CMN-12

Document with identifier [%s] not found

Документ з ідентифікатором [%s] не знайдено

400

ERR_CMN-12

Chain with identifier [%s] not found

Ланцюг з ідентифікатором [%s] не знайдено

400

ERR_CMN-13

Attachment with identifier [%s] not found

Вкладення з ідентифікатором [%s] не знайдено

400

ERR_CMN-14

Ticket not found

Квитанцію не знайдено

400

ERR_CMN-15

Package with identifier [%s] not found

Пакет з ідентифікатором [%s] не знайдено

400

ERR_CMN-16

Incorrect format of field’s value

Некоректний формат значення поля

400

ERR_CMN-17

error

Помилка в роботі процедури (БД)

400

ERR_CMN-18

Document body already exist

Тіло документа вже існує

Дублювання тіла документа

400

ERR_CMN-19

Transformer for document type [%s] not found

Перетворювач для типу документа [%s] не знайдено

Не вдалось знайти компонент для перетворення xml в json / json в xml і т.д.

400

ERR_CMN-20

Transforming error

Помилка перетворення

Помилка при перетворенні, наприклад: при перетворенні xml в json, коли xml не відповідає специфікації документа

400

ERR_CMN-21

Malformed JSON

Невірно сформований JSON

Неправильні дані / некоректний формат в полі json

Код помилки

Опис

Рекомендовані дії

500

Не класифікована помилка

У випадку, якщо Ви отримали у тілі відповіді подібний текст “Internal Server Error. Channel ID: 45b696af”, то зверніться за допомогою до нашої тех. підтримки. Якщо Ви отримали інший текст помилки, то прочитайте її і спробуйте зрозуміти. В багатьох випадках, проблема буде описана.

502

Сервер не відповідає

Перевірте ваше інтернет з’єднання. Якщо все гаразд, то спробуйте повторити раніше надісланий запит.

504

Тайм-аут отримання відповіді з сервера

У випадку надсилання запиту, що змінює дані (наприклад, підписання документа) ми рекомендуємо перевіряти виконання попереднього запиту (наприклад, чи був доданий підпис). З затримкою в 5 секунд надішліть запит для перевірки виконання Вашого попереднього запиту. Якщо Ваш попередній запит не виконався з будь-яких причин, повторіть його.

520

Сервісна помилка

Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

521

Сервісна помилка

Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

522

Сервісна помилка

Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

523

Сервісна помилка

Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

524

Сервісна помилка

Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

525

Сервісна помилка

Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.

526

Сервісна помилка

Запит не був опрацьований нашими серверами. З затримкою в 5 секунд, повторіть Ваш запит.