Skip to content

Commit b6d9ad9

Browse files
authored
Fix issues in management api walkthrough (#2578)
Signed-off-by: Lars Geyer-Blaumeiser <lars.blaumeiser@cofinity-x.com>
1 parent 3e51d9d commit b6d9ad9

File tree

3 files changed

+7
-8
lines changed

3 files changed

+7
-8
lines changed

docs/usage/management-api-walkthrough/04_catalog.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -174,7 +174,7 @@ The returned payload is a `dcat:Catalog` as specified by the DSP version used in
174174
"action": "use",
175175
"constraint": {
176176
"leftOperand": "FrameworkAgreement",
177-
"operand": "eq",
177+
"operator": "eq",
178178
"rightOperand": "DataExchangeGovernance:1.0"
179179
},
180180
"prohibition": [],

docs/usage/management-api-walkthrough/05_contractnegotiations.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -34,9 +34,9 @@ Content-Type: application/json
3434
"@id": "{{OFFER_ID}}",
3535
"target": "{{ASSET_ID}}",
3636
"assigner": "{{PROVIDER_IDENTIFIER}}",
37-
"permission": {{OFFER_ODRL_PERMISSION}},
38-
"prohibition": {{OFFER_ODRL_PROHIBITION}},
39-
"obligation": {{OFFER_ODRL_OBLIGATION}}
37+
"permission": [],
38+
"prohibition": [],
39+
"obligation": []
4040
},
4141
"callbackAddresses": [
4242
{
@@ -61,7 +61,9 @@ section which refers to an existing published context definition.
6161
- `protocol` is the providers' supported protocol
6262
- In the `policy` section, the Data Consumer specifies the Data Offer for the negotiation. As there may be multiple
6363
Data Offers for the same DataSet, the Data Consumer must choose one.
64-
It must hold an identical copy of the Data Offer's contract policy as provided via the catalog-API in the `odrl:hasPolicy` field plus:
64+
It must hold an identical copy of the Data Offer's contract policy as provided via the catalog-API in the `odrl:hasPolicy`
65+
field. Especially the `permission`, `prohibition` and `obligation` fields must contain the exact same `odrl` clauses as
66+
found in the offer. In addition, two more properties are required:
6567
- `assigner` must hold the identifier of the Provider (BPN OR DID, as returned in the catalog response)
6668
- `target` must be the id of the EDC-Asset/dcat:DataSet that the offer was made for.
6769
- `callbackAddresses` is a list of Consumer-side endpoints that the Provider's Data Plane writes events to.

docs/usage/management-api-walkthrough/06_transferprocesses.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,13 +42,11 @@ Content-Type: application/json
4242
"@vocab": "https://w3id.org/edc/v0.0.1/ns/"
4343
},
4444
"@type": "TransferRequest",
45-
"assetId": "{{ASSET_ID}}",
4645
"contractId": "{{CONTRACT_AGREEMENT_ID}}",
4746
"counterPartyAddress": "{{CONNECTOR_ADDRESS}}",
4847
"dataDestination": {
4948
"type": "<supported-transfer-type>"
5049
},
51-
"privateProperties": {},
5250
"protocol": "dataspace-protocol-http:2025-1",
5351
"transferType": "HttpData-PULL",
5452
"callbackAddresses": [
@@ -68,7 +66,6 @@ Content-Type: application/json
6866
}
6967
```
7068

71-
- `assetId` is the id of the [asset](01_assets.md) that a transfer process should be triggered for.
7269
- `counterPartyAddress` is the DSP-endpoint of the Data Provider (usually ending on /api/v1/dsp).
7370
- `contractId` represents the Contract Agreement that the Provider and Consumer agreed on during the [Contract Negotiation](05_contractnegotiations.md)
7471
phase.

0 commit comments

Comments
 (0)