Start a negotiation (provider)

POST

/dsp/negotiations/request

curl --request POST \
  --url https://example.com/dsp/negotiations/request \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

A consumer’s ContractRequestMessage for an offer in our catalog. The policies are checked against the caller’s credentials; an offer that needs approval waits for an operator.

Authorizations

• dcp

Request Body^required

A ContractRequestMessage.

Media typeapplication/json

object

Example ^generated

{}

Responses

201

A ContractNegotiation in state REQUESTED.

Media typeapplication/json

object

Example ^generated

{}

400

Not a valid message, or not allowed in the state of the process.

Media typeapplication/json

A DSP error (dspace:…Error): code and reason, as JSON-LD.

object

@context

required

object

@type

required

E.g. ContractNegotiationError.

string

code

required

string

reason

required

Array<string>

Example ^generated

{
  "@context": {},
  "@type": "example",
  "code": "example",
  "reason": [
    "example"
  ]
}

401

No valid token.

Media typeapplication/json

A DSP error (dspace:…Error): code and reason, as JSON-LD.

object

@context

required

object

@type

required

E.g. ContractNegotiationError.

string

code

required

string

reason

required

Array<string>

Example ^generated

{
  "@context": {},
  "@type": "example",
  "code": "example",
  "reason": [
    "example"
  ]
}

503

The message could not be recorded as evidence, so it was not processed.

Media typeapplication/json

A DSP error (dspace:…Error): code and reason, as JSON-LD.

object

@context

required

object

@type

required

E.g. ContractNegotiationError.

string

code

required

string

reason

required

Array<string>

Example ^generated

{
  "@context": {},
  "@type": "example",
  "code": "example",
  "reason": [
    "example"
  ]
}