Аутентифікація
Деякі запити API (особливо GET запити лише для читання) не потребують аутентифікації. Інші, ті, які модифікують дані у базі даних, потребують аутентифікації брокера через ключ API. Додатково видаються токени власника, щоб забезпечити кілька ролей дійових осіб при створенні об’єкта.
Ключі API
Basic Authenication
Ключ API - це ім’я користувача, що буде використовуватись зі схемою базової аутентифікації (див. RFC 2617#section-2).
Bearer Authenication
Ключ API - це токен, що буде використовуватись для аутентифікації.
Токени власника
Отримання токена
Токен видається, коли об’єкт створюється в базі даних:
Request
POST /api/2.5/tenders?opt_pretty=1 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"title": "футляри до державних нагород",
"title_en": "Cases with state awards",
"title_ru": "футляры к государственным наградам",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"countryName": "Україна",
"postalCode": "01220",
"region": "м. Київ",
"locality": "м. Київ",
"streetAddress": "вул. Банкова, 11, корпус 1"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"telephone": "+380950000000",
"email": "example@email.com",
"iban": "111111111111111",
"authorizedBy": "Статут компанії",
"position": "Генеральний директор"
}
},
"value": {
"amount": 500,
"currency": "UAH"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"classification": {
"scheme": "ДК021",
"id": "44617100-9",
"description": "Cartons"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"unit": {
"name": "кілограм",
"code": "KGM",
"value": {
"amount": 6
}
},
"quantity": 5,
"relatedLot": "047349442ebb49bea5933a2c6cbc6ad7"
}
],
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00"
},
"tenderPeriod": {
"endDate": "2023-10-24T00:00:00+02:00"
},
"procurementMethodType": "belowThreshold",
"mode": "test",
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
]
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"code": "prepayment",
"type": "financing",
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"percentage": 45.55,
"relatedLot": "047349442ebb49bea5933a2c6cbc6ad7"
},
{
"title": "deliveryOfGoods",
"code": "postpayment",
"type": "financing",
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"percentage": 54.45,
"relatedLot": "047349442ebb49bea5933a2c6cbc6ad7"
}
],
"mainProcurementCategory": "services",
"contractTemplateName": "00000000.0002.01",
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "047349442ebb49bea5933a2c6cbc6ad7",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
]
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}
Response
HTTP/1.0 201 Created
Content-Type: application/json
Location: http://lb-api-sandbox.prozorro.gov.ua/api/2.5/tenders/2f5e224866d0459cbaa950a15be70946
{
"data": {
"mainProcurementCategory": "services",
"title_en": "[TESTING] Cases with state awards",
"title_ru": "[ТЕСТИРОВАНИЕ] футляры к государственным наградам",
"contractTemplateName": "00000000.0002.01",
"title": "[ТЕСТУВАННЯ] футляри до державних нагород",
"mode": "test",
"status": "draft",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-24T00:00:00+02:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"date": "2023-10-10T01:00:00+03:00",
"id": "047349442ebb49bea5933a2c6cbc6ad7",
"status": "active",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"features": [
{
"code": "OCDS-123454-AIR-INTAKE",
"featureOf": "item",
"relatedItem": "ffffffffffffffffffffffffffffffff",
"title": "Потужність всмоктування",
"title_en": "Air Intake",
"description": "Ефективна потужність всмоктування пилососа, в ватах (аероватах)",
"enum": [
{
"value": 0.1,
"title": "До 1000 Вт"
},
{
"value": 0.15,
"title": "Більше 1000 Вт"
}
]
},
{
"code": "OCDS-123454-YEARS",
"featureOf": "tenderer",
"title": "Років на ринку",
"title_en": "Years trading",
"description": "Кількість років, які організація учасник працює на ринку",
"enum": [
{
"value": 0.05,
"title": "До 3 років"
},
{
"value": 0.1,
"title": "Більше 3 років, менше 5 років"
},
{
"value": 0.15,
"title": "Більше 5 років"
}
]
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1,
"relatedLot": "047349442ebb49bea5933a2c6cbc6ad7"
},
{
"id": "58f52177f7fe40d8ad54876b665a8fbf",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2,
"relatedLot": "047349442ebb49bea5933a2c6cbc6ad7"
}
],
"procurementMethodType": "belowThreshold",
"enquiryPeriod": {
"endDate": "2023-10-17T00:00:00+02:00",
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-19T00:00:00+03:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "047349442ebb49bea5933a2c6cbc6ad7"
}
],
"tenderID": "UA-2023-10-10-000002-a",
"owner": "broker",
"procurementMethod": "open",
"submissionMethod": "electronicAuction",
"date": "2023-10-10T01:00:00+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:00+03:00",
"id": "2f5e224866d0459cbaa950a15be70946"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
},
"access": {
"token": "f220033fc2004e90a9398defdea66c9f",
"transfer": "842e5674013b4f14abb7f87624dd4f80"
}
}
У відповіді є access разом з token. Це значення можна використати для модифікації об’єктів у «ролі Власника».
Використання токена
Ви можете передати токен доступу такими способами:
параметр рядка URL запиту acc_token
заголовок HTTP запиту X-Access-Token
access.token в тілі запитів POST/PUT/PATCH
Ось приклад, де токен передається як рядок URL запиту:
Request
PATCH /api/2.5/tenders/3f5ff57c43ca4ba6b3a1d0619b7a14c3?acc_token=312a92a0096444fa9b9761b0af134205 HTTP/1.0
Authorization: Bearer broker
Content-Type: application/json
Host: lb-api-sandbox.prozorro.gov.ua
{
"data": {
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
}
}
}
Response
HTTP/1.0 200 OK
Content-Type: application/json
{
"data": {
"contractTemplateName": "00000000.0002.01",
"date": "2023-10-10T01:00:00+03:00",
"dateModified": "2023-10-10T01:00:01+03:00",
"dateCreated": "2023-10-10T01:00:00+03:00",
"tenderID": "UA-2023-10-10-000001-a",
"documents": [
{
"confidentiality": "public",
"documentType": "notice",
"id": "cd8449f4d78c4f088c61ca2d58851f67",
"datePublished": "2023-10-10T01:00:00+03:00",
"hash": "md5:00000000000000000000000000000000",
"title": "sign.p7s",
"format": "sign/pkcs7-signature",
"url": "http://public-docs-sandbox.prozorro.gov.ua/get/cdb6e7cdd13c424ca6d701372a9e7de1?Signature=%2B4SXU9Ao9xR1zTNFK4AzMIh%2BFZN4b25SfjdO69%2FfmaM8%2FcKMeDB0Xa2jCG%2FgA25Q5u3c5StwiOD10dl8ZqyEAw%3D%3D&KeyID=a8968c46",
"documentOf": "tender",
"dateModified": "2023-10-10T01:00:00+03:00",
"author": "tender_owner",
"language": "uk"
}
],
"status": "active.enquiries",
"owner": "broker",
"title": "футляри до державних нагород",
"mainProcurementCategory": "goods",
"procurementMethod": "open",
"noticePublicationDate": "2023-10-10T01:00:00+03:00",
"submissionMethod": "electronicAuction",
"awardCriteria": "lowestCost",
"procuringEntity": {
"name": "Державне управління справами",
"identifier": {
"scheme": "UA-EDR",
"id": "00037256",
"uri": "http://www.dus.gov.ua/"
},
"address": {
"streetAddress": "вул. Банкова, 11, корпус 1",
"locality": "м. Київ",
"region": "м. Київ",
"postalCode": "01220",
"countryName": "Україна"
},
"contactPoint": {
"name": "Державне управління справами",
"telephone": "+0440000000"
},
"kind": "general",
"signerInfo": {
"name": "Test Testovich",
"email": "example@email.com",
"telephone": "+380950000000",
"iban": "111111111111111",
"position": "Генеральний директор",
"authorizedBy": "Статут компанії"
}
},
"value": {
"currency": "UAH",
"valueAddedTaxIncluded": true,
"amount": 500.0
},
"next_check": "2023-10-17T00:00:00+02:00",
"tenderPeriod": {
"startDate": "2023-10-17T00:00:00+02:00",
"endDate": "2023-10-25T01:00:11+03:00"
},
"lots": [
{
"title": "lot title",
"description": "lot description",
"status": "active",
"id": "d6fba8716672449f87efa3a5781c7760",
"date": "2023-10-10T01:00:00+03:00",
"value": {
"amount": 500.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"minimalStep": {
"amount": 15.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
}
}
],
"milestones": [
{
"id": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"title": "signingTheContract",
"type": "financing",
"code": "prepayment",
"percentage": 45.55,
"duration": {
"days": 2,
"type": "banking"
},
"sequenceNumber": 1
},
{
"id": "cf51460eec4e4fa18e979c6e8381ca16",
"title": "deliveryOfGoods",
"type": "financing",
"code": "postpayment",
"percentage": 54.45,
"duration": {
"days": 900,
"type": "calendar"
},
"sequenceNumber": 2
}
],
"procurementMethodType": "belowThreshold",
"enquiryPeriod": {
"startDate": "2023-10-10T01:00:00+03:00",
"clarificationsUntil": "2023-10-19T00:00:00+03:00",
"endDate": "2023-10-17T00:00:00+02:00"
},
"items": [
{
"id": "ffffffffffffffffffffffffffffffff",
"description": "футляри до державних нагород",
"description_en": "Cases with state awards",
"description_ru": "футляры к государственным наградам",
"unit": {
"name": "кілограм",
"value": {
"amount": 6.0,
"currency": "UAH",
"valueAddedTaxIncluded": true
},
"code": "KGM"
},
"quantity": 5.0,
"classification": {
"description": "Cartons",
"scheme": "ДК021",
"id": "44617100-9"
},
"additionalClassifications": [
{
"scheme": "ДКПП",
"id": "17.21.1",
"description": "папір і картон гофровані, паперова й картонна тара"
}
],
"relatedLot": "d6fba8716672449f87efa3a5781c7760"
}
],
"id": "3f5ff57c43ca4ba6b3a1d0619b7a14c3"
},
"config": {
"hasAuction": true,
"hasAwardingOrder": true,
"hasValueRestriction": true,
"valueCurrencyEquality": true,
"hasPrequalification": false,
"minBidsNumber": 1,
"hasPreSelectionAgreement": false,
"hasTenderComplaints": false,
"hasAwardComplaints": false,
"hasCancellationComplaints": false,
"hasValueEstimation": true,
"hasQualificationComplaints": false,
"tenderComplainRegulation": 0,
"qualificationComplainDuration": 0,
"awardComplainDuration": 2,
"cancellationComplainDuration": 0,
"clarificationUntilDuration": 1,
"qualificationDuration": 0,
"minTenderingDuration": 2,
"hasEnquiries": true,
"minEnquiriesDuration": 3,
"enquiryPeriodRegulation": 0,
"restricted": false
}
}