Отримання інформації про закупівлі

Отримати список всіх закупівель

GET /tenders HTTP/1.1
HTTP/1.1 200 OK

Сортування

Повернені закупівлі просортовані за датою модифікації.

Обмежити кількість Закупівель, що повертаються

Ви можете контролювати кількість data записів потоку даних закупівлі (розмір пакета) за допомогою параметра limit. Якщо він не вказаний, то дані будуть повернені пакетами по 100 елементів.

Пакети

Відповідь містить елемент next_page з такими властивостями:

offset:

Це параметр, який ви повинні додати до вихідного запиту, щоб отримати наступну сторінку.

path:

Це частина шляху URL-адреси з вихідними параметрами та доданим/заміненим offset параметром вище.

uri:

Повна версія URL-адреси для наступної сторінки.

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

Синхронізація

Часто необхідно мати можливість синхронізувати зміни центральної бази даних з іншою базою даних (ми будемо називати її “локальною”). Стандартне сортування “за датою модифікації” разом із механізмом пакетування дозволяє ефективно здійснювати синхронізацію. Процес синхронізації може виконуватись посторінково, поки не буде жодних нових даних, що повертаються. Тоді синхронізатор призупиниться на деякий час, щоб дозволити центральній базі даних зареєструвати деякі зміни і спробувати завантажити наступну сторінку. next_page гарантує, що усі зміни з останнього запиту будуть включені у новий пакет.

Безпечна частота запитів на синхронізацію це раз в 5 хвилин.

Прочитати інформацію про окремі закупівлі

GET /tenders/64e93250be76435397e8c992ed4214d1 HTTP/1.1
HTTP/1.1 200 OK

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

GET /tenders/64e93250be76435397e8c992ed4214d1/documents HTTP/1.1
HTTP/1.1 200 OK

Приклад запиту:

GET /api/2.3/tenders/f3641d0ba0f042e8b49de06d5c7921af/documents HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: api-sandbox.openprocurement.org


200 OK
Content-Type: application/json; charset=UTF-8

{
  "data": [
    {
      "hash": "md5:00000000000000000000000000000000",
      "description": "document description modified",
      "title": "Notice.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/33bd696eba8a4877af96fc267df48c21?KeyID=459f8ecf&Signature=ddH8OS09K%252BBpHxgERTqBTtRkfEU1q6Lj65I1JeIn%2FlcdEC6e2eOs936ScnDmRUAtryWyyLR75Zt6aaB1%2FLtWBw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.044656+03:00",
      "author": "tender_owner",
      "documentType": "technicalSpecifications",
      "id": "8c4f7355fed4463b98eb429237a2e6a5",
      "dateModified": "2017-07-25T17:36:56.044677+03:00"
    },
    {
      "hash": "md5:00000000000000000000000000000000",
      "author": "tender_owner",
      "title": "AwardCriteria.pdf",
      "url": "http://public.docs-sandbox.openprocurement.org/get/9892238f746f4c4099a4bad0c365fd2b?KeyID=459f8ecf&Signature=ysTqp33c7XMcniHmMMRwEbzHqlh7u0B1Xody%2F3MDOvWweLLYYutsDvREJ4lJcsnLkpv9HRVECjPJt2vGmv8GBw%253D%253D",
      "format": "application/pdf",
      "documentOf": "tender",
      "datePublished": "2017-07-25T17:36:56.140078+03:00",
      "id": "14f948894bcc4ddc9da4d2129b028116",
      "dateModified": "2017-07-25T17:36:56.140097+03:00"
    }
  ]
}

Прочитати документ закупівлі

Документ можна отримати за допомогою запиту url-адреси з відповіді на запит списку документів у data[*].url. URL для скачування безпечно надавати кінцевому користувачу.