Transfer-Processes

Last updated 4 months ago

Was this helpful?

get

Gets an transfer process with the given ID

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '//v2/transferprocesses/{id}'

200

400

404

{
  "@context": {
    "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
  },
  "@type": "https://w3id.org/edc/v0.0.1/ns/TransferProcess",
  "@id": "process-id",
  "correlationId": "correlation-id",
  "type": "PROVIDER",
  "state": "STARTED",
  "stateTimestamp": 1688465655,
  "assetId": "asset-id",
  "contractId": "contractId",
  "dataDestination": {
    "type": "data-destination-type"
  },
  "privateProperties": {
    "private-key": "private-value"
  },
  "errorDetail": "eventual-error-detail",
  "createdAt": 1688465655,
  "callbackAddresses": [
    {
      "transactional": false,
      "uri": "http://callback/url",
      "events": [
        "contract.negotiation",
        "transfer.process"
      ],
      "authKey": "auth-key",
      "authCodeId": "auth-code-id"
    }
  ]
}

The transfer process

post

Requests the deprovisioning of resources associated with a transfer process. Due to the asynchronous nature of transfers, a successful response only indicates that the request was successfully received. This may take a long time, so clients must poll the /{id}/state endpoint to track the state.

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '//v2/transferprocesses/{id}/deprovision'

204

400

404

No Content

Request to deprovision the transfer process was successfully received

get

Gets the state of a transfer process with the given ID

Path parameters

idstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url '//v2/transferprocesses/{id}/state'

200

400

404

{
  "@context": {
    "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
  },
  "@type": "https://w3id.org/edc/v0.0.1/ns/TransferState",
  "state": "STARTED"
}

The transfer process's state

post

Initiates a data transfer with the given parameters. Due to the asynchronous nature of transfers, a successful response only indicates that the request was successfully received. This may take a long time, so clients must poll the /{id}/state endpoint to track the state.

Body

@contextobjectrequired

@typestringoptionalExample: https://w3id.org/edc/v0.0.1/ns/TransferRequest

assetIdstringrequired

callbackAddressesobject[]optionalExample: null

connectorAddressstringoptionalDeprecated

please use counterPartyAddress instead

connectorIdstringoptionalDeprecated

Provider connector id is stored in the contract agreement

contractIdstringrequired

counterPartyAddressstringrequired

dataDestinationobjectoptional

privatePropertiesobjectoptional

protocolstringrequired

transferTypestringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '//v2/transferprocesses' \
  --header 'Content-Type: application/json' \
  --data '{
    "@context": {
      "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
    },
    "@type": "https://w3id.org/edc/v0.0.1/ns/TransferRequest",
    "protocol": "dataspace-protocol-http",
    "counterPartyAddress": "http://provider-address",
    "contractId": "contract-id",
    "assetId": "asset-id",
    "transferType": "transferType",
    "dataDestination": {
      "type": "data-destination-type"
    },
    "privateProperties": {
      "private-key": "private-value"
    },
    "callbackAddresses": [
      {
        "transactional": false,
        "uri": "http://callback/url",
        "events": [
          "contract.negotiation",
          "transfer.process"
        ],
        "authKey": "auth-key",
        "authCodeId": "auth-code-id"
      }
    ]
  }'

200

400

{
  "@context": {
    "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
  },
  "@id": "id-value",
  "createdAt": 1688465655
}

The transfer was successfully initiated. Returns the transfer process ID and created timestamp

post

Returns all transfer process according to a query

Body

@typestringoptionalExample: https://w3id.org/edc/v0.0.1/ns/QuerySpec

filterExpressionobject[]optionalExample:

{"@context":{"@vocab":"https://w3id.org/edc/v0.0.1/ns/"},"@type":"Criterion","operandLeft":"fieldName","operator":"=","operandRight":"some value"}

limitinteger · int32optional

offsetinteger · int32optional

sortFieldstringoptional

sortOrderstring · enumoptionalAvailable options:

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '//v2/transferprocesses/request' \
  --header 'Content-Type: application/json' \
  --data '{
    "@context": {
      "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
    },
    "@type": "QuerySpec",
    "offset": 5,
    "limit": 10,
    "sortOrder": "DESC",
    "sortField": "fieldName",
    "filterExpression": []
  }'

200

400

No Content

The transfer processes matching the query

post

Requests the termination of a transfer process. Due to the asynchronous nature of transfers, a successful response only indicates that the request was successfully received. This may take a long time, so clients must poll the /{id}/state endpoint to track the state.

Path parameters

idstringrequired

Body

@typestringoptionalExample: https://w3id.org/edc/v0.0.1/ns/TerminateTransfer

statestringoptional

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --request POST \
  --url '//v2/transferprocesses/{id}/terminate' \
  --header 'Content-Type: application/json' \
  --data '{
    "@context": {
      "@vocab": "https://w3id.org/edc/v0.0.1/ns/"
    },
    "@type": "https://w3id.org/edc/v0.0.1/ns/TerminateTransfer",
    "reason": "a reason to terminate"
  }'

204

400

404

409

No Content

Request to terminate the transfer process was successfully received

Show child attributes

Show child attributes

Show child attributes