Exchanges

An exchange defines how data was exchanged and for what purpose it can be used.

Get all exchanges

You can retrieve all exchanges.

GET /exchange/ HTTP/1.1
Host: [DIGITA_HOST]
Authorization: Bearer [ACCESS_TOKEN]
[
    {
        "uri": "https%3A%2F%2Fexample.org%2Fexchange%2F1234-5678-9012-3456",
        "purpose": "https%3A%2F%2Fexample.org%2Fpurpose%2F1234-5678-9012-3456",
        "holder": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456",
        "source": "https%3A%2F%2Fexample.org%2Fsource%2F1234-5678-9012-3456",
        "connection": "https%3A%2F%2Fexample.org%2Fconnection%2F1234-5678-9012-3456"
    },
    {
        "uri": "https%3A%2F%2Fexample.org%2Fexchange%2F1234-5678-9012-3456",
        "purpose": "https%3A%2F%2Fexample.org%2Fpurpose%2F1234-5678-9012-3456",
        "holder": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456",
        "source": "https%3A%2F%2Fexample.org%2Fsource%2F1234-5678-9012-3456",
        "connection": "https%3A%2F%2Fexample.org%2Fconnection%2F1234-5678-9012-3456"
    }
]

Get one exchange

You can retrieve a single exchange.

GET /exchange/[EXCHANGE_URI] HTTP/1.1
Host: [DIGITA_HOST]
Authorization: Bearer [ACCESS_TOKEN]
{
    "uri": "https%3A%2F%2Fexample.org%2Fexchange%2F1234-5678-9012-3456",
    "purpose": "https%3A%2F%2Fexample.org%2Fpurpose%2F1234-5678-9012-3456",
    "holder": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456",
    "source": "https%3A%2F%2Fexample.org%2Fsource%2F1234-5678-9012-3456",
    "connection": "https%3A%2F%2Fexample.org%2Fconnection%2F1234-5678-9012-3456"
}

Create one exchange

You can create a single exchange.

POST /exchange/ HTTP/1.1
Host: [DIGITA_HOST]
Authorization: Bearer [ACCESS_TOKEN]

{
    "purpose": "https%3A%2F%2Fexample.org%2Fpurpose%2F1234-5678-9012-3456",
    "holder": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456",
    "source": "https%3A%2F%2Fexample.org%2Fsource%2F1234-5678-9012-3456",
    "connection": "https%3A%2F%2Fexample.org%2Fconnection%2F1234-5678-9012-3456"
}
{
    "uri": "https%3A%2F%2Fexample.org%2Fexchange%2F1234-5678-9012-3456",
    "purpose": "https%3A%2F%2Fexample.org%2Fpurpose%2F1234-5678-9012-3456",
    "holder": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456",
    "source": "https%3A%2F%2Fexample.org%2Fsource%2F1234-5678-9012-3456",
    "connection": "https%3A%2F%2Fexample.org%2Fconnection%2F1234-5678-9012-3456"
}

Update one exchange

You can update a single exchange.

PUT /exchange/[EXCHANGE_URI] HTTP/1.1
Host: [DIGITA_HOST]
Authorization: Bearer [ACCESS_TOKEN]

{
    "uri": "https%3A%2F%2Fexample.org%2Fexchange%2F1234-5678-9012-3456",
    "purpose": "https%3A%2F%2Fexample.org%2Fpurpose%2F1234-5678-9012-3456",
    "holder": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456",
    "source": "https%3A%2F%2Fexample.org%2Fsource%2F1234-5678-9012-3456",
    "connection": "https%3A%2F%2Fexample.org%2Fconnection%2F1234-5678-9012-3456"
}
{
    "uri": "https%3A%2F%2Fexample.org%2Fexchange%2F1234-5678-9012-3456",
    "purpose": "https%3A%2F%2Fexample.org%2Fpurpose%2F1234-5678-9012-3456",
    "holder": "https%3A%2F%2Fexample.org%2Fholder%2F1234-5678-9012-3456",
    "source": "https%3A%2F%2Fexample.org%2Fsource%2F1234-5678-9012-3456",
    "connection": "https%3A%2F%2Fexample.org%2Fconnection%2F1234-5678-9012-3456"
}