Туторіал

Базові правила

Подивимось як працює точка входу claimRights:

GET /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "next_page": {
    "path": "/api/0.1/assets?offset=", 
    "uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets?offset=", 
    "offset": ""
  }, 
  "data": []
}

При виклику видає пустий набір.

Спробуймо створити нове право вимоги:

POST /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/x-www-form-urlencoded
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 415 Unsupported Media Type
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error", 
  "errors": [
    {
      "description": "Content-Type header should be one of ['application/json']", 
      "location": "header", 
      "name": "Content-Type"
    }
  ]
}

Помилка вказує, що єдиний прийнятний тип вмісту це application/json.

Задовільнимо вимогу типу вмісту:

POST /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 4
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 422 Unprocessable Entity
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "status": "error", 
  "errors": [
    {
      "description": "No JSON object could be decoded", 
      "location": "body", 
      "name": "data"
    }
  ]
}

Помилка вказує, що data не знайдено у тілі JSON.

Створення активу

Створимо claim right з мінімально допустимим набором даних (тільки параметри, обовязкові для заповнення):

POST /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3673
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "assetType": "claimRights", 
    "classification": {
      "scheme": "CAV", 
      "id": "39513200-3", 
      "description": "Земельні ділянки"
    }, 
    "title": "Земля для космодрому", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "id": "39513200-3", 
          "description": "Cartons"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "countryName": "Україна", 
          "postalCode": "79000", 
          "region": "м. Київ", 
          "streetAddress": "вул. Банкова 1", 
          "locality": "м. Київ"
        }, 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "id": "39513200-3", 
          "description": "Cartons"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "countryName": "Україна", 
          "postalCode": "79000", 
          "region": "м. Київ", 
          "streetAddress": "вул. Банкова 1", 
          "locality": "м. Київ"
        }, 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "value": {
      "currency": "UAH", 
      "amount": 100
    }, 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "address": {
      "countryName": "Україна", 
      "postalCode": "79000", 
      "region": "м. Київ", 
      "streetAddress": "вул. Банкова 1", 
      "locality": "м. Київ"
    }, 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100
      }, 
      "value": {
        "currency": "UAH", 
        "amount": 1
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "debtorType": "legalPerson"
    }, 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "countryName": "Україна", 
        "postalCode": "01220", 
        "region": "м. Київ", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "locality": "м. Київ"
      }
    }, 
    "quantity": 5
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets/a994c96b07b54deca896b1fead29c6ba
X-Content-Type-Options: nosniff
{
  "access": {
    "token": "1195acb2b5e74428a48032be515e8ecf"
  }, 
  "data": {
    "status": "draft", 
    "assetType": "claimRights", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000001", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "e1ae2d2a0d2a4aef844646e0550b1f63", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "1719393675e14e51a94d20d9558dbab6", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:12.239143+03:00", 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:12.233087+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "a994c96b07b54deca896b1fead29c6ba", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}
PATCH /api/0.1/assets/a994c96b07b54deca896b1fead29c6ba?acc_token=1195acb2b5e74428a48032be515e8ecf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "status": "pending"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "pending", 
    "assetType": "claimRights", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000001", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "e1ae2d2a0d2a4aef844646e0550b1f63", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "1719393675e14e51a94d20d9558dbab6", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:12.305963+03:00", 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:12.305767+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "a994c96b07b54deca896b1fead29c6ba", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}

Успіх! Тепер ми бачимо, що новий об’єкт було створено. Код відповіді 201 та заголовок відповіді Location вказує місцерозташування створеного об’єкта. Тіло відповіді показує інформацію про створене право вимоги, його внутрішній id (яке співпадає з сегментом Location), його офіційний assetID та dateModified (дату, що показує час, коли право вимоги востаннє модифікувалося). Зверніть увагу на assetType, а також на те, що право вимоги створюється зі статусом pending.

Використаємо URL створеного об’єкта (заголовок відповіді Location):

GET /api/0.1/assets/a994c96b07b54deca896b1fead29c6ba HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "pending", 
    "assetType": "claimRights", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000001", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "e1ae2d2a0d2a4aef844646e0550b1f63", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "1719393675e14e51a94d20d9558dbab6", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:12.305963+03:00", 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:12.305767+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "a994c96b07b54deca896b1fead29c6ba", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}

Ми бачимо ту ж відповідь, що і після створення активу.

Подивимось, що показує список прав вимоги:

GET /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "next_page": {
    "path": "/api/0.1/assets?offset=2017-09-26T11%3A39%3A12.305963%2B03%3A00", 
    "uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets?offset=2017-09-26T11%3A39%3A12.305963%2B03%3A00", 
    "offset": "2017-09-26T11:39:12.305963+03:00"
  }, 
  "data": [
    {
      "id": "a994c96b07b54deca896b1fead29c6ba", 
      "dateModified": "2017-09-26T11:39:12.305963+03:00"
    }
  ]
}

Ми бачимо внутрішнє id права вимоги та його dateModified дату.

Попереднє право вимоги було створене лише з обов’язковими полями. Тепер додамо право вимоги з максимально допустимим набором даних при створенні (право вимоги повинне бути у статусі created).

POST /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 3673
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "assetType": "claimRights", 
    "classification": {
      "scheme": "CAV", 
      "id": "39513200-3", 
      "description": "Земельні ділянки"
    }, 
    "title": "Земля для космодрому", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "id": "39513200-3", 
          "description": "Cartons"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "countryName": "Україна", 
          "postalCode": "79000", 
          "region": "м. Київ", 
          "streetAddress": "вул. Банкова 1", 
          "locality": "м. Київ"
        }, 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "id": "39513200-3", 
          "description": "Cartons"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "countryName": "Україна", 
          "postalCode": "79000", 
          "region": "м. Київ", 
          "streetAddress": "вул. Банкова 1", 
          "locality": "м. Київ"
        }, 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "value": {
      "currency": "UAH", 
      "amount": 100
    }, 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "address": {
      "countryName": "Україна", 
      "postalCode": "79000", 
      "region": "м. Київ", 
      "streetAddress": "вул. Банкова 1", 
      "locality": "м. Київ"
    }, 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100
      }, 
      "value": {
        "currency": "UAH", 
        "amount": 1
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "debtorType": "legalPerson"
    }, 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "countryName": "Україна", 
        "postalCode": "01220", 
        "region": "м. Київ", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "locality": "м. Київ"
      }
    }, 
    "quantity": 5
  }
}

Response: 201 Created
Content-Type: application/json
Location: http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets/75b11ba80dc74164ab8862e243874933
X-Content-Type-Options: nosniff
{
  "access": {
    "token": "1fce0707515b423681f82f9d639baa0c"
  }, 
  "data": {
    "status": "draft", 
    "assetType": "claimRights", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000002", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "7e64a2e3a3e1476c8d7dc6cdcd511057", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "d9536444955541f0ac7693bc647bb11b", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:12.527629+03:00", 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:12.522965+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "75b11ba80dc74164ab8862e243874933", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}

І знову код відповіді 201 Created, заголовок Location і тіло з додатковим id, assetID, та властивість dateModified.

Перевіримо, що містить реєстр активів:

GET /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "next_page": {
    "path": "/api/0.1/assets?offset=2017-09-26T11%3A39%3A12.305963%2B03%3A00", 
    "uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets?offset=2017-09-26T11%3A39%3A12.305963%2B03%3A00", 
    "offset": "2017-09-26T11:39:12.305963+03:00"
  }, 
  "data": [
    {
      "id": "a994c96b07b54deca896b1fead29c6ba", 
      "dateModified": "2017-09-26T11:39:12.305963+03:00"
    }
  ]
}

Дійсно, в нас зараз є два активи.

Модифікація права вимоги

Оновимо право вимоги шляхом надання йому усіх інших важливих властивостей:

PATCH /api/0.1/assets/a994c96b07b54deca896b1fead29c6ba?acc_token=1195acb2b5e74428a48032be515e8ecf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 347
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "description": "Земельні ділянки із великими покладами благородних металів"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "pending", 
    "assetType": "claimRights", 
    "description": "Земельні ділянки із великими покладами благородних металів", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000001", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "e1ae2d2a0d2a4aef844646e0550b1f63", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "1719393675e14e51a94d20d9558dbab6", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:12.641441+03:00", 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:12.305767+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "a994c96b07b54deca896b1fead29c6ba", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}

Ми бачимо, що додаткові властивості об’єднані з існуючими даними права вимоги. Додатково оновлена властивість dateModified, щоб відображати останню дату модифікації.

Ще одна перевірка списку відображає нову дату модифікації:

GET /api/0.1/assets?opt_pretty=1 HTTP/1.0
Authorization: Basic YnJva2VyOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "next_page": {
    "path": "/api/0.1/assets?offset=2017-09-26T11%3A39%3A12.641441%2B03%3A00", 
    "uri": "http://lb.api-sandbox.registry.ea.openprocurement.net/api/0.1/assets?offset=2017-09-26T11%3A39%3A12.641441%2B03%3A00", 
    "offset": "2017-09-26T11:39:12.641441+03:00"
  }, 
  "data": [
    {
      "id": "a994c96b07b54deca896b1fead29c6ba", 
      "dateModified": "2017-09-26T11:39:12.641441+03:00"
    }
  ]
}

Видалення права вимоги

Видалимо право вимоги

PATCH /api/0.1/assets/a994c96b07b54deca896b1fead29c6ba?acc_token=1195acb2b5e74428a48032be515e8ecf HTTP/1.0
Authorization: Basic YnJva2VyOg==
Content-Length: 31
Content-Type: application/json
Host: lb.api-sandbox.registry.ea.openprocurement.net
DATA:
{
  "data": {
    "status": "deleted"
  }
}

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "deleted", 
    "assetType": "claimRights", 
    "description": "Земельні ділянки із великими покладами благородних металів", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000001", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "e1ae2d2a0d2a4aef844646e0550b1f63", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "1719393675e14e51a94d20d9558dbab6", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:12.806743+03:00", 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:12.806531+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "a994c96b07b54deca896b1fead29c6ba", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}

Інтеграція з лотами

GET /api/0.1/assets/f1102253359c4aeb88ccb3aad828e9c5 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "active", 
    "relatedLot": "22477826f75848109a087a6838ce814e", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000003", 
    "assetType": "claimRights", 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:13.202895+03:00", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "42cf59d44cef42ac95ec62ff9675d20c", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "c57dcb9278544f5a99ae7f8f022c2700", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:13.202674+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "f1102253359c4aeb88ccb3aad828e9c5", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}
GET /api/0.1/assets/f1102253359c4aeb88ccb3aad828e9c5 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "pending", 
    "relatedLot": "22477826f75848109a087a6838ce814e", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000003", 
    "assetType": "claimRights", 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:13.283238+03:00", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "42cf59d44cef42ac95ec62ff9675d20c", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "c57dcb9278544f5a99ae7f8f022c2700", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:13.283027+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "f1102253359c4aeb88ccb3aad828e9c5", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}
GET /api/0.1/assets/f1102253359c4aeb88ccb3aad828e9c5 HTTP/1.0
Authorization: Basic Y29uY2llcmdlOg==
Host: lb.api-sandbox.registry.ea.openprocurement.net

Response: 200 OK
Content-Type: application/json
X-Content-Type-Options: nosniff
{
  "data": {
    "status": "complete", 
    "relatedLot": "eb19e4ad403c48ee89f73b43327ee9c4", 
    "classification": {
      "scheme": "CAV", 
      "description": "Земельні ділянки", 
      "id": "39513200-3"
    }, 
    "title": "Земля для космодрому", 
    "assetID": "UA-AR-DGF-2017-09-26-000003", 
    "assetType": "claimRights", 
    "value": {
      "currency": "UAH", 
      "amount": 100.0, 
      "valueAddedTaxIncluded": true
    }, 
    "dateModified": "2017-09-26T11:39:13.500382+03:00", 
    "items": [
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "42cf59d44cef42ac95ec62ff9675d20c", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }, 
      {
        "description": "футляри до державних нагород", 
        "classification": {
          "scheme": "CAV", 
          "description": "Cartons", 
          "id": "39513200-3"
        }, 
        "additionalClassifications": [
          {
            "scheme": "ДКПП", 
            "id": "17.21.1", 
            "description": "папір і картон гофровані, паперова й картонна тара"
          }
        ], 
        "address": {
          "postalCode": "79000", 
          "countryName": "Україна", 
          "streetAddress": "вул. Банкова 1", 
          "region": "м. Київ", 
          "locality": "м. Київ"
        }, 
        "id": "c57dcb9278544f5a99ae7f8f022c2700", 
        "unit": {
          "code": "44617100-9", 
          "name": "item"
        }, 
        "quantity": 5
      }
    ], 
    "owner": "broker", 
    "assetCustodian": {
      "contactPoint": {
        "name": "Державне управління справами", 
        "telephone": "0440000000"
      }, 
      "identifier": {
        "scheme": "UA-EDR", 
        "id": "00037256", 
        "uri": "http://www.dus.gov.ua/"
      }, 
      "name": "Державне управління справами", 
      "address": {
        "postalCode": "01220", 
        "countryName": "Україна", 
        "streetAddress": "вул. Банкова, 11, корпус 1", 
        "region": "м. Київ", 
        "locality": "м. Київ"
      }
    }, 
    "address": {
      "postalCode": "79000", 
      "countryName": "Україна", 
      "streetAddress": "вул. Банкова 1", 
      "region": "м. Київ", 
      "locality": "м. Київ"
    }, 
    "date": "2017-09-26T11:39:13.500182+03:00", 
    "debt": {
      "agreementNumber": "42", 
      "debtCurrencyValue": {
        "currency": "USD", 
        "amount": 100.0
      }, 
      "dateSigned": "2017-08-16T12:30:17.615196+03:00", 
      "value": {
        "currency": "UAH", 
        "amount": 1.0
      }, 
      "debtorType": "legalPerson"
    }, 
    "id": "f1102253359c4aeb88ccb3aad828e9c5", 
    "unit": {
      "code": "39513200-3", 
      "name": "item"
    }, 
    "quantity": 5
  }
}