Обмежений доступ

Фреймворк може мати обмежений доступ з наступними правилами

Object Публічний API Приватний API (Замовник) Приватний API (Учасник)
framework перегляд перегляд/редагування перегляд
submission перегляд (всі) перегляд/редагування (власні)
qualification перегляд/редагування (всі) перегляд (власні)
agreement перегляд/редагування (всі)

Домовимось, що Замовник та Учасники будуть використовувати різних брокерів для роботи з API:

  • Замовник використовує Broker
  • Учасник 1 використовує Broker 1
  • Учасник 2 використовує Broker 2

Створення фреймворку з обмеженим доступом

Спочатку створимо фреймворк з обмеженим доступом за допомогою Broker. Для цього нам потрібно встановити restricted_derivatives поле в true в config розділі запиту на створення фреймворку.

Request

POST /api/2.5/frameworks HTTP/1.0
Authorization: Bearer broker
Content-Length: 1873
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "frameworkType": "dynamicPurchasingSystem",
    "procuringEntity": {
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Назва організації"
      },
      "kind": "defense",
      "address": {
        "countryName": "Україна",
        "postalCode": "01220",
        "region": "м. Київ",
        "locality": "м. Київ",
        "streetAddress": "вул. Банкова, 11, корпус 1"
      },
      "name": "Державне управління справами"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "classification": {
      "scheme": "ДК021",
      "description": "Mustard seeds",
      "id": "03111600-8"
    },
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "qualificationPeriod": {
      "endDate": "2023-03-02T00:00:00+02:00"
    }
  },
  "config": {
    "restrictedDerivatives": true
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/frameworks/9bd2fdb5579045be9cfff9fb1a397e32

{
  "data": {
    "prettyID": "UA-F-2023-01-01-000001",
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "date": "2023-01-01T00:00:00+02:00",
    "dateCreated": "2023-01-01T00:00:00+02:00",
    "dateModified": "2023-01-01T00:00:00+02:00",
    "owner": "broker",
    "status": "draft",
    "qualificationPeriod": {
      "endDate": "2023-03-02T00:00:00+02:00"
    },
    "frameworkType": "dynamicPurchasingSystem",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Назва організації"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "defense"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "id": "9bd2fdb5579045be9cfff9fb1a397e32"
  },
  "access": {
    "token": "77e8aeb431c44efa97ff595190dc86ba",
    "transfer": "5d5818a5c50648bda23a4c0a93eeeb2f"
  },
  "config": {
    "restrictedDerivatives": true
  }
}

Цей фреймворк сам по собі видно всім в публічному API.

Примітка

Для ProcuringEntity з kind defense поле restricted_derivatives буде встановлено в true автоматично.

Другий крок - перехід фреймворку в статус active:

Request

PATCH /api/2.5/frameworks/9bd2fdb5579045be9cfff9fb1a397e32?acc_token=77e8aeb431c44efa97ff595190dc86ba HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "prettyID": "UA-F-2023-01-01-000001",
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "date": "2023-01-01T00:00:00+02:00",
    "dateCreated": "2023-01-01T00:00:00+02:00",
    "dateModified": "2023-01-01T00:00:00+02:00",
    "owner": "broker",
    "status": "active",
    "period": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-01-31T00:00:00+02:00"
    },
    "qualificationPeriod": {
      "startDate": "2023-01-01T00:00:01+02:00",
      "endDate": "2023-03-02T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-01-01T00:00:01+02:00"
    },
    "frameworkType": "dynamicPurchasingSystem",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Назва організації"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "defense"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "id": "9bd2fdb5579045be9cfff9fb1a397e32",
    "next_check": "2023-01-28T00:00:00+02:00"
  },
  "config": {
    "restrictedDerivatives": true
  }
}

Створення та активація пропозицій з обмеженим доступом

Після активації фреймворку користувачі можуть зареєструвати свої пропозиції в період від framework.enquiryPeriod.endDate до period.Date.

Зареєструємо пропозицію за допомогою Broker 1:

Request

POST /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker1
Content-Length: 1236
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "tenderers": [
      {
        "address": {
          "countryName": "Україна",
          "locality": "м. Вінниця",
          "postalCode": "21100",
          "region": "Вінницька область",
          "streetAddress": "вул. Островського, 33"
        },
        "contactPoint": {
          "email": "soleksuk@gmail.com",
          "name": "Сергій Олексюк",
          "telephone": "+380432216930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "id": "00137256",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Школяр»",
        "scale": "micro"
      }
    ],
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32"
  },
  "config": {
    "restricted": true
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/d96d76a4ef4f4d3eae4b099d0404e31f

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        }
      }
    ],
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "date": "2023-01-17T00:00:00+02:00",
    "owner": "broker1",
    "status": "draft",
    "submissionType": "dynamicPurchasingSystem",
    "id": "d96d76a4ef4f4d3eae4b099d0404e31f"
  },
  "access": {
    "token": "7048bca78fdf467eafe0dd61ec2b9436",
    "transfer": "0a0710cb5c4a4dbb84a7d89a1c3b28f6"
  },
  "config": {
    "restricted": true
  }
}

Ви можете побачити, що поле restricted було встановлено в true в розділі config відповіді на створення пропозиції.

Далі активуємо пропозицію за допомогою Broker 1:

Request

PATCH /api/2.5/submissions/d96d76a4ef4f4d3eae4b099d0404e31f?acc_token=7048bca78fdf467eafe0dd61ec2b9436 HTTP/1.0
Authorization: Bearer broker1
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        }
      }
    ],
    "qualificationID": "cc849b4a29b54c009ad286797a9cdf35",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "date": "2023-01-17T00:00:00+02:00",
    "datePublished": "2023-01-17T00:00:00+02:00",
    "owner": "broker1",
    "status": "active",
    "submissionType": "dynamicPurchasingSystem",
    "id": "d96d76a4ef4f4d3eae4b099d0404e31f"
  },
  "config": {
    "restricted": true
  }
}

Додамо ще одну пропозицію за допомогою Broker 2:

Request

POST /api/2.5/submissions HTTP/1.0
Authorization: Bearer broker2
Content-Length: 1214
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "tenderers": [
      {
        "address": {
          "countryName": "Україна",
          "locality": "м. Львів",
          "postalCode": "79013",
          "region": "Львівська область",
          "streetAddress": "вул. Островського, 34"
        },
        "contactPoint": {
          "email": "aagt@gmail.com",
          "name": "Андрій Олексюк",
          "telephone": "+380322916930"
        },
        "identifier": {
          "scheme": "UA-EDR",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "id": "00137226",
          "uri": "http://www.sc.gov.ua/"
        },
        "name": "ДКП «Книга»",
        "scale": "sme"
      }
    ],
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32"
  },
  "config": {
    "restricted": true
  }
}

Response

HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/submissions/2a997181ec504fcdbfaf4c759a02895e

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Книга»",
        "scale": "sme",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        }
      }
    ],
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "date": "2023-01-17T00:00:00+02:00",
    "owner": "broker2",
    "status": "draft",
    "submissionType": "dynamicPurchasingSystem",
    "id": "2a997181ec504fcdbfaf4c759a02895e"
  },
  "access": {
    "token": "d6c27e24c6f24928a7a62d93b05c4358",
    "transfer": "8d522fd75a7f453ea94689fa853f23af"
  },
  "config": {
    "restricted": true
  }
}

І активуємо її:

Request

PATCH /api/2.5/submissions/2a997181ec504fcdbfaf4c759a02895e?acc_token=d6c27e24c6f24928a7a62d93b05c4358 HTTP/1.0
Authorization: Bearer broker2
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Книга»",
        "scale": "sme",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        }
      }
    ],
    "qualificationID": "9ef8a439d3f346dd9e86bb05c4f55f8b",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "date": "2023-01-17T00:00:00+02:00",
    "datePublished": "2023-01-17T00:00:00+02:00",
    "owner": "broker2",
    "status": "active",
    "submissionType": "dynamicPurchasingSystem",
    "id": "2a997181ec504fcdbfaf4c759a02895e"
  },
  "config": {
    "restricted": true
  }
}

Запит пропозицій з обмеженим доступом

Перевіримо пропозиції всіх учасників:

Broker (Замовник)

Перевіримо фід пропозицій для Broker, який є Замовником та має доступ до всіх пропозицій фреймворку:

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "status": "active",
      "id": "d96d76a4ef4f4d3eae4b099d0404e31f"
    },
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "status": "active",
      "id": "2a997181ec504fcdbfaf4c759a02895e"
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0"
  }
}

Тепер зробимо запит за допомогою Broker для пропозиції, створеної Broker 1:

Request

GET /api/2.5/submissions/d96d76a4ef4f4d3eae4b099d0404e31f HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        }
      }
    ],
    "qualificationID": "cc849b4a29b54c009ad286797a9cdf35",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "date": "2023-01-17T00:00:00+02:00",
    "datePublished": "2023-01-17T00:00:00+02:00",
    "owner": "broker1",
    "status": "active",
    "submissionType": "dynamicPurchasingSystem",
    "id": "d96d76a4ef4f4d3eae4b099d0404e31f"
  },
  "config": {
    "restricted": true
  }
}

Тепер зробимо запит за допомогою Broker для пропозиції, створеної Broker 2:

Request

GET /api/2.5/submissions/2a997181ec504fcdbfaf4c759a02895e HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Книга»",
        "scale": "sme",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        }
      }
    ],
    "qualificationID": "9ef8a439d3f346dd9e86bb05c4f55f8b",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "date": "2023-01-17T00:00:00+02:00",
    "datePublished": "2023-01-17T00:00:00+02:00",
    "owner": "broker2",
    "status": "active",
    "submissionType": "dynamicPurchasingSystem",
    "id": "2a997181ec504fcdbfaf4c759a02895e"
  },
  "config": {
    "restricted": true
  }
}

Broker 1 (Учасник 1)

Перевіримо фід пропозицій для Broker 1, який є Учасником 1 та має доступ тільки до власних пропозицій:

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "status": "active",
      "id": "d96d76a4ef4f4d3eae4b099d0404e31f"
    },
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "2a997181ec504fcdbfaf4c759a02895e",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0"
  }
}

Ми бачимо, що друга пропозиція частково видна в фіді і позначена полем restricted, встановленим в true.

Тепер зробимо запит за допомогою Broker 1 для пропозиції, створеної Broker 1:

Request

GET /api/2.5/submissions/d96d76a4ef4f4d3eae4b099d0404e31f HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Школяр»",
        "scale": "micro",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137256",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 33",
          "locality": "м. Вінниця",
          "region": "Вінницька область",
          "postalCode": "21100",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Сергій Олексюк",
          "email": "soleksuk@gmail.com",
          "telephone": "+380432216930"
        }
      }
    ],
    "qualificationID": "cc849b4a29b54c009ad286797a9cdf35",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "date": "2023-01-17T00:00:00+02:00",
    "datePublished": "2023-01-17T00:00:00+02:00",
    "owner": "broker1",
    "status": "active",
    "submissionType": "dynamicPurchasingSystem",
    "id": "d96d76a4ef4f4d3eae4b099d0404e31f"
  },
  "config": {
    "restricted": true
  }
}

Тепер зробимо запит за допомогою Broker 1 для пропозиції, створеної Broker 2:

Request

GET /api/2.5/submissions/2a997181ec504fcdbfaf4c759a02895e HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for submission object"
    }
  ]
}

Ми бачимо повідомлення про помилку, що пропозиція обмежена для Broker 1.

Broker 2 (Учасник 2)

Перевіримо фід пропозицій для Broker 2, який є Учасником 2 та має доступ тільки до власних пропозицій:

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "status": "active",
      "id": "d96d76a4ef4f4d3eae4b099d0404e31f"
    },
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "2a997181ec504fcdbfaf4c759a02895e",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0"
  }
}

Тепер зробимо запит за допомогою Broker 2 для пропозиції, створеної Broker 1:

Request

GET /api/2.5/submissions/d96d76a4ef4f4d3eae4b099d0404e31f HTTP/1.0
Authorization: Bearer broker2
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for submission object"
    }
  ]
}

Тепер зробимо запит за допомогою Broker 2 для пропозиції, створеної Broker 2:

Request

GET /api/2.5/submissions/2a997181ec504fcdbfaf4c759a02895e HTTP/1.0
Authorization: Bearer broker2
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "tenderers": [
      {
        "name": "ДКП «Книга»",
        "scale": "sme",
        "identifier": {
          "scheme": "UA-EDR",
          "id": "00137226",
          "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
          "uri": "http://www.sc.gov.ua/"
        },
        "address": {
          "streetAddress": "вул. Островського, 34",
          "locality": "м. Львів",
          "region": "Львівська область",
          "postalCode": "79013",
          "countryName": "Україна"
        },
        "contactPoint": {
          "name": "Андрій Олексюк",
          "email": "aagt@gmail.com",
          "telephone": "+380322916930"
        }
      }
    ],
    "qualificationID": "9ef8a439d3f346dd9e86bb05c4f55f8b",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "date": "2023-01-17T00:00:00+02:00",
    "datePublished": "2023-01-17T00:00:00+02:00",
    "owner": "broker2",
    "status": "active",
    "submissionType": "dynamicPurchasingSystem",
    "id": "2a997181ec504fcdbfaf4c759a02895e"
  },
  "config": {
    "restricted": true
  }
}

Анонімно

Перевіримо фід пропозицій з анонімним запитом (або будь-яким брокером, який не є Broker або Broker 1):

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "d96d76a4ef4f4d3eae4b099d0404e31f",
      "restricted": true
    },
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "2a997181ec504fcdbfaf4c759a02895e",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0"
  }
}

Тепер зробимо запит для пропозиції, створеної Broker 1:

Request

GET /api/2.5/submissions/d96d76a4ef4f4d3eae4b099d0404e31f HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for submission object"
    }
  ]
}

Тепер зробимо запит для пропозиції, створеної Broker 2:

Request

GET /api/2.5/submissions/2a997181ec504fcdbfaf4c759a02895e HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for submission object"
    }
  ]
}

Запит кваліфікацій з обмеженим доступом

Перевіримо кваліфікації всіх учасників:

Broker (Замовник)

Перевіримо фід кваліфікацій для Broker, який є Замовником та має доступ до всіх кваліфікацій фреймворку:

Request

GET /api/2.5/submissions?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "status": "active",
      "id": "d96d76a4ef4f4d3eae4b099d0404e31f"
    },
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "status": "active",
      "id": "2a997181ec504fcdbfaf4c759a02895e"
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/submissions?opt_fields=frameworkID%2Cstatus&offset=1673906400.0"
  }
}

Тепер зробимо запит за допомогою Broker для кваліфікації пропозиції, створеної Broker 1:

Request

GET /api/2.5/qualifications/cc849b4a29b54c009ad286797a9cdf35 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "submissionID": "d96d76a4ef4f4d3eae4b099d0404e31f",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "date": "2023-01-17T00:00:00+02:00",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "status": "pending",
    "qualificationType": "dynamicPurchasingSystem",
    "id": "cc849b4a29b54c009ad286797a9cdf35"
  },
  "config": {
    "restricted": true
  }
}

Тепер зробимо запит за допомогою Broker для кваліфікації пропозиції, створеної Broker 2:

Request

GET /api/2.5/qualifications/9ef8a439d3f346dd9e86bb05c4f55f8b HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "submissionID": "2a997181ec504fcdbfaf4c759a02895e",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "date": "2023-01-17T00:00:00+02:00",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "status": "pending",
    "qualificationType": "dynamicPurchasingSystem",
    "id": "9ef8a439d3f346dd9e86bb05c4f55f8b"
  },
  "config": {
    "restricted": true
  }
}

Broker 1 (Учасник 1)

Перевіримо фід кваліфікацій для Broker 1, який є Учасником 1 та має доступ тільки до власних кваліфікацій:

Request

GET /api/2.5/qualifications?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "status": "pending",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "cc849b4a29b54c009ad286797a9cdf35"
    },
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "9ef8a439d3f346dd9e86bb05c4f55f8b",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1673906400.0"
  }
}

Ми бачимо, що друга кваліфікація частково видна в фіді і позначена полем restricted, встановленим в true.

Тепер зробимо запит за допомогою Broker 1 для кваліфікації пропозиції, створеної Broker 1:

Request

GET /api/2.5/qualifications/cc849b4a29b54c009ad286797a9cdf35 HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "submissionID": "d96d76a4ef4f4d3eae4b099d0404e31f",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "date": "2023-01-17T00:00:00+02:00",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "status": "pending",
    "qualificationType": "dynamicPurchasingSystem",
    "id": "cc849b4a29b54c009ad286797a9cdf35"
  },
  "config": {
    "restricted": true
  }
}

Потім зробимо запит за допомогою Broker 1 для кваліфікації пропозиції, створеної Broker 2:

Request

GET /api/2.5/qualifications/9ef8a439d3f346dd9e86bb05c4f55f8b HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for qualification object"
    }
  ]
}

Ми бачимо повідомлення про помилку, що кваліфікація обмежена для Broker 1.

Broker 2 (Учасник 2)

Перевіримо фід кваліфікацій для Broker 2, який є Учасником 2 та має доступ тільки до власних кваліфікацій:

Request

GET /api/2.5/qualifications?opt_fields=frameworkID,status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "status": "pending",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "cc849b4a29b54c009ad286797a9cdf35"
    },
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "9ef8a439d3f346dd9e86bb05c4f55f8b",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1673906400.0"
  }
}

Тепер зробимо запит за допомогою Broker 2 для кваліфікації пропозиції, створеної Broker 1:

Request

GET /api/2.5/qualifications/cc849b4a29b54c009ad286797a9cdf35 HTTP/1.0
Authorization: Bearer broker2
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for qualification object"
    }
  ]
}

Потім зробимо запит за допомогою Broker 2 для кваліфікації пропозиції, створеної Broker 2:

Request

GET /api/2.5/qualifications/9ef8a439d3f346dd9e86bb05c4f55f8b HTTP/1.0
Authorization: Bearer broker2
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "submissionID": "2a997181ec504fcdbfaf4c759a02895e",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "date": "2023-01-17T00:00:00+02:00",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "status": "pending",
    "qualificationType": "dynamicPurchasingSystem",
    "id": "9ef8a439d3f346dd9e86bb05c4f55f8b"
  },
  "config": {
    "restricted": true
  }
}

Анонімно

Перевіримо фід кваліфікацій з анонімним запитом (або будь-яким брокером, який не є Broker або Broker 1):

Request

GET /api/2.5/qualifications?opt_fields=frameworkID,status HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "cc849b4a29b54c009ad286797a9cdf35",
      "restricted": true
    },
    {
      "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "9ef8a439d3f346dd9e86bb05c4f55f8b",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/qualifications?opt_fields=frameworkID%2Cstatus&offset=1673906400.0"
  }
}

Тепер зробимо запит для кваліфікації пропозиції, створеної Broker 1:

Request

GET /api/2.5/qualifications/cc849b4a29b54c009ad286797a9cdf35 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for qualification object"
    }
  ]
}

Потім зробимо запит для кваліфікації пропозиції, створеної Broker 2:

Request

GET /api/2.5/qualifications/9ef8a439d3f346dd9e86bb05c4f55f8b HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for qualification object"
    }
  ]
}

Активуція кваліфікації з обмеженим доступом

Активуємо всі кваліфікації за допомогою Broker:

Request

PATCH /api/2.5/qualifications/cc849b4a29b54c009ad286797a9cdf35?acc_token=77e8aeb431c44efa97ff595190dc86ba HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "submissionID": "d96d76a4ef4f4d3eae4b099d0404e31f",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "date": "2023-01-17T00:00:00+02:00",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "status": "active",
    "qualificationType": "dynamicPurchasingSystem",
    "id": "cc849b4a29b54c009ad286797a9cdf35"
  },
  "config": {
    "restricted": true
  }
}

Request

PATCH /api/2.5/qualifications/9ef8a439d3f346dd9e86bb05c4f55f8b?acc_token=77e8aeb431c44efa97ff595190dc86ba HTTP/1.0
Authorization: Bearer broker
Content-Length: 30
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua

{
  "data": {
    "status": "active"
  }
}

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "submissionID": "2a997181ec504fcdbfaf4c759a02895e",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "date": "2023-01-17T00:00:00+02:00",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "status": "active",
    "qualificationType": "dynamicPurchasingSystem",
    "id": "9ef8a439d3f346dd9e86bb05c4f55f8b"
  },
  "config": {
    "restricted": true
  }
}

Перевіримо поточний фреймворк

Request

GET /api/2.5/frameworks/9bd2fdb5579045be9cfff9fb1a397e32 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "prettyID": "UA-F-2023-01-01-000001",
    "title": "Узагальнена назва закупівлі",
    "description": "Назва предмета закупівлі",
    "date": "2023-01-01T00:00:00+02:00",
    "dateCreated": "2023-01-01T00:00:00+02:00",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "owner": "broker",
    "status": "active",
    "period": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-01-31T00:00:00+02:00"
    },
    "qualificationPeriod": {
      "startDate": "2023-01-01T00:00:01+02:00",
      "endDate": "2023-03-02T00:00:00+02:00"
    },
    "enquiryPeriod": {
      "startDate": "2023-01-01T00:00:00+02:00",
      "endDate": "2023-01-01T00:00:01+02:00"
    },
    "frameworkType": "dynamicPurchasingSystem",
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Назва організації"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "defense"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "agreementID": "bee1ec7b25674a89918be6257ac54948",
    "id": "9bd2fdb5579045be9cfff9fb1a397e32",
    "next_check": "2023-01-28T00:00:00+02:00"
  },
  "config": {
    "restrictedDerivatives": true
  }
}

Ви можете побачити, що agreementID з’явився в поточному фреймворку, тому перевіримо цю угоду.

Запит угоди з обмеженим доступом

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

Broker (Замовник)

Перевіримо фід угод для Broker, який є Замовником та має доступ до угоди фреймворку:

Request

GET /api/2.5/agreements?opt_fields=status HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "status": "active",
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "bee1ec7b25674a89918be6257ac54948"
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/agreements?opt_fields=status&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?opt_fields=status&offset=1673906400.0"
  }
}

Тепер зробимо запит за допомогою Broker для угоди:

Request

GET /api/2.5/agreements/bee1ec7b25674a89918be6257ac54948 HTTP/1.0
Authorization: Bearer broker
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": {
    "agreementID": "UA-2023-01-17-000001",
    "status": "active",
    "date": "2023-01-17T00:00:00+02:00",
    "dateCreated": "2023-01-17T00:00:00+02:00",
    "dateModified": "2023-01-17T00:00:00+02:00",
    "owner": "broker",
    "agreementType": "dynamicPurchasingSystem",
    "frameworkID": "9bd2fdb5579045be9cfff9fb1a397e32",
    "period": {
      "startDate": "2023-01-17T00:00:00+02:00",
      "endDate": "2023-03-02T00:00:00+02:00"
    },
    "procuringEntity": {
      "name": "Державне управління справами",
      "identifier": {
        "scheme": "UA-EDR",
        "id": "00037256",
        "legalName": "Назва організації"
      },
      "address": {
        "countryName": "Україна",
        "streetAddress": "вул. Банкова, 11, корпус 1",
        "locality": "м. Київ",
        "region": "м. Київ",
        "postalCode": "01220"
      },
      "contactPoint": {
        "name": "Державне управління справами",
        "telephone": "+0440000000",
        "email": "aa@aa.com"
      },
      "kind": "defense"
    },
    "classification": {
      "description": "Mustard seeds",
      "scheme": "ДК021",
      "id": "03111600-8"
    },
    "additionalClassifications": [
      {
        "scheme": "ДК003",
        "id": "17.21.1",
        "description": "папір і картон гофровані, паперова й картонна тара"
      }
    ],
    "contracts": [
      {
        "id": "c4097bf28bf54a74a1b43bb30a89ff82",
        "qualificationID": "cc849b4a29b54c009ad286797a9cdf35",
        "status": "active",
        "submissionID": "d96d76a4ef4f4d3eae4b099d0404e31f",
        "suppliers": [
          {
            "name": "ДКП «Школяр»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137256",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр»",
              "uri": "http://www.sc.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Островського, 33",
              "locality": "м. Вінниця",
              "region": "Вінницька область",
              "postalCode": "21100",
              "countryName": "Україна"
            },
            "scale": "micro",
            "contactPoint": {
              "name": "Сергій Олексюк",
              "email": "soleksuk@gmail.com",
              "telephone": "+380432216930"
            }
          }
        ],
        "milestones": [
          {
            "id": "fbd402379bd84422bd390a0cee4fa0fd",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-03-02T00:00:00+02:00",
            "dateModified": "2023-01-17T00:00:00+02:00"
          }
        ],
        "date": "2023-01-17T00:00:00+02:00"
      },
      {
        "id": "14104aac4e7948538eb39b6d1fea4f5c",
        "qualificationID": "9ef8a439d3f346dd9e86bb05c4f55f8b",
        "status": "active",
        "submissionID": "2a997181ec504fcdbfaf4c759a02895e",
        "suppliers": [
          {
            "name": "ДКП «Книга»",
            "identifier": {
              "scheme": "UA-EDR",
              "id": "00137226",
              "legalName": "Державне комунальне підприємство громадського харчування «Школяр 2»",
              "uri": "http://www.sc.gov.ua/"
            },
            "address": {
              "streetAddress": "вул. Островського, 34",
              "locality": "м. Львів",
              "region": "Львівська область",
              "postalCode": "79013",
              "countryName": "Україна"
            },
            "scale": "sme",
            "contactPoint": {
              "name": "Андрій Олексюк",
              "email": "aagt@gmail.com",
              "telephone": "+380322916930"
            }
          }
        ],
        "milestones": [
          {
            "id": "28cdfb5f22a14074844a5059104419cf",
            "type": "activation",
            "status": "scheduled",
            "dueDate": "2023-03-02T00:00:00+02:00",
            "dateModified": "2023-01-17T00:00:00+02:00"
          }
        ],
        "date": "2023-01-17T00:00:00+02:00"
      }
    ],
    "id": "bee1ec7b25674a89918be6257ac54948",
    "next_check": "2023-03-02T00:00:00+02:00"
  },
  "config": {
    "restricted": true
  }
}

Broker 1 (Учасник 1)

Перевіримо фід угод для Broker 1:

Request

GET /api/2.5/agreements?opt_fields=status HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "bee1ec7b25674a89918be6257ac54948",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/agreements?opt_fields=status&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?opt_fields=status&offset=1673906400.0"
  }
}

Тепер зробимо запит за допомогою Broker 1 для угоди:

Request

GET /api/2.5/agreements/bee1ec7b25674a89918be6257ac54948 HTTP/1.0
Authorization: Bearer broker1
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for agreement object"
    }
  ]
}

Broker 2 (Учасник 2)

Перевіримо фід угод для Broker 2:

Request

GET /api/2.5/agreements?opt_fields=status HTTP/1.0
Authorization: Bearer broker2
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "bee1ec7b25674a89918be6257ac54948",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/agreements?opt_fields=status&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?opt_fields=status&offset=1673906400.0"
  }
}

Тепер зробимо запит за допомогою Broker 2 для угоди:

Request

GET /api/2.5/agreements/bee1ec7b25674a89918be6257ac54948 HTTP/1.0
Authorization: Bearer broker2
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for agreement object"
    }
  ]
}

Анонімно

Перевіримо фід угод з анонімним запитом (або будь-яким брокером, який не є Broker або Broker 1):

Request

GET /api/2.5/agreements?opt_fields=status HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 200 OK
Content-Type: application/json

{
  "data": [
    {
      "dateModified": "2023-01-17T00:00:00+02:00",
      "id": "bee1ec7b25674a89918be6257ac54948",
      "restricted": true
    }
  ],
  "next_page": {
    "offset": 1673906400.0,
    "path": "/api/2.5/agreements?opt_fields=status&offset=1673906400.0",
    "uri": "http://public-api-sandbox.prozorro.gov.ua/api/2.5/agreements?opt_fields=status&offset=1673906400.0"
  }
}

Тепер зробимо запит для угоди:

Request

GET /api/2.5/agreements/bee1ec7b25674a89918be6257ac54948 HTTP/1.0
Host: public-api-sandbox.prozorro.gov.ua

Response

HTTP/1.0 403 Forbidden
Content-Type: application/json

{
  "status": "error",
  "errors": [
    {
      "location": "body",
      "name": "data",
      "description": "Access restricted for agreement object"
    }
  ]
}