Огляд

Open Procurement API це єдиний інтерфейс для бази даних Open Procurement, що є основним елементом інфраструктури Open Procurement.

Open Procurement API це REST-ful інтерфейс, що надає програмний доступ до бази даних Tender системи Open Procurement. Він надає URL-адреси для доступу до ресурсів і використовує вбудовані HTTP особливості, щоб отримувати команди та повертати відповіді. Це полегшує спілкування.

API приймає JSON або form-encoded вміст у запитах. Він повертає JSON вміст у всіх свої відповідях, включно з помилками. Підтримується лише UTF-8 кодування і для запитів, і для відповідей.

Домовленості

Всі API POST та PUT запити очікують об’єкт верхнього рівня з єдиним елементом з назвою data. Відповіді з повідомленням про успіх будуть віддзеркалювати цей формат. Елемент data повинен сам бути об’єктом, що містить параметри запиту. Якщо створюється нова закупівля, то це ті поля, які ми хочемо встановити на самій закупівлі.

Якщо запит був успішним, ми отримаємо код відповіді 201, який вказує, що об’єкт був створений. Ця відповідь буде мати data поле на верхньому рівні, яке вміщуватиме повну інформацію про нову закупівлю, включно з ID.

Якщо під час запиту виникли труднощі, ми отримаємо інший код стану та JSON, який при поверненні міститиме errors поле на верхньому рівні зі списком проблем. Ми дивимось на першу з них і видруковуємо її повідомлення.

Основні задачі

Бізнес логіка

Стан проекту

Статус цього проекту - перед-альфа

Репозиторій джерельних текстів цього проекту є на GitHub.

Повідомляйте про всі проблеми та поради через issue tracker (реєстрація на GitHub обов’язкова).

Загальне обговорення відбувається через розсилку Open Procurement General.

Загальну інформацію, пояснення та технічні специфікації можна знайти на сайті openprocurement.org.

Стабільність API

API є дуже нестабільним. Хоча точки входу API будуть відносно стабільними, формати обміну даними будуть часно змінюватись. Зміни в API обговорюються через Open Procurement API розсилку.

Звіт про зміни

0.10

Випущено: не випущено

Нові властивості:

0.8

Випущено: 2015-05-12

Нові властивості:

  • Період зупинки для кожної винагороди окремо

  • Додано новий механізм скасування тендера

0.7

Випущено: 2015-03-13

Нові властивості:

  • Обов’язкове встановлення назви, класифікації та additionalClassifications

  • Додана валідація для однакових cpv груп товарів

  • Дадано завантаження документів закупівлі користувачем аукціону

  • Закриття закупівлі реєстрацією угоди

  • Жорсткий режим для операцій з патчами

  • Відміна активної винагороди

Модифікації:

  • Автентифікований доступ до бази даних couchdb

  • Виправлена аутентифікація методів PUT та PATCH

  • Оптимізовано запити до БД при старті

  • Виправлені поля deliveryLocation

  • Виправлено поле редагування формату в Документах

  • Виправлені обмеження заватаження документів цінової пропозиції

0.6

Випущено: 2014-12-15

Нові властивості:

  • Авторизація токена брокера

  • Авторизація токена дійової особи

  • Додано Item.deliveryLocation

  • Блокування завершення закупівлі через невирішені скарги

  • Перенесення невдалих аукціонів

0.5

Випущено: не випущено

Нові властивості:

  • Генерація токена дійової особи

  • Додано Item.deliveryAddress

  • Логіка послідовного розгляду визначення переможця

Модифікації:

  • Tender.deliveryDate перенесено до Item.deliveryDate

0.4

Випущено: 2014-12-01

Нові властивості:

  • Подання скарги на визначення переможця

  • Додатки до скарг

  • Відміна закупівлі

  • Видимість авторів питань

Модифікації:

  • Уточнення списку статусів закупівлі

0.3

Випущено: 2014-11-21

Нові властивості:

  • Можливість задавати питання

  • Подача скарги на тендерні умови

  • Можливість відповідати на запитання

  • Публікація вирішення скарги

  • Вичитка запитань та відповідей, скарг та їх рішень

  • Планувальник аукціону

  • Контролер аукціону

Модифікації:

  • Стандарт даних налаштований відповідно до Open Contracting 1.0RC

  • точки входу /bidders/ перейменовані в /bids/

  • властивість modified перейменована в modificationDate

0.2

Випущено: 2014-11-07

  • Сортування списку закупівель (оптимізоване для синхронних операцій)

  • Вичитка документів

  • Відстеження змін

  • Опції: Pretty-print, JSONP

  • Впровадження станів та перемикання станів з урахуванням часу

0.1

Випущено: 2014-10-24

  • Налаштування загальної збірки, тестування, розгортання та ci фреймворка.

  • Створення/модифікація закупівлі

  • Додавання/модифікація/відміна цінової пропозиції

  • Визначення переможця/дискваліфікація цінових пропозицій

Наступні кроки

Можливо вам буде цікаво прочитати Туторіал, або API Довідник.