Transfer ticket between participants

PATCH/participants/transfer-ticket

Transfers a ticket from one participant to another. This is an authenticated route.

The x-fingerprint-id header is required. Without it, the API returns 401 with the message Fingerprint must be provided.

Request

curl --request PATCH \
  --url 'https://9iq81tsdy4.execute-api.sa-east-1.amazonaws.com/participants/transfer-ticket' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-api-secret: YOUR_API_SECRET' \
  --header 'x-fingerprint-id: 928371' \
  --header 'Content-Type: application/json' \
  --data '{
  "ticketId": "11111111-2222-3333-4444-555555555555",
  "fromParticipant": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "toParticipant": "ffffffff-1111-2222-3333-444444444444"
}'

const response = await fetch('https://9iq81tsdy4.execute-api.sa-east-1.amazonaws.com/participants/transfer-ticket', {
  method: 'PATCH',
  headers: {
    'x-api-key': 'YOUR_API_KEY',
    'x-api-secret': 'YOUR_API_SECRET',
    'x-fingerprint-id': '928371',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "ticketId": "11111111-2222-3333-4444-555555555555",
    "fromParticipant": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "toParticipant": "ffffffff-1111-2222-3333-444444444444"
  }),
});

const data = await response.json();
console.log(data);

import requests

url = "https://9iq81tsdy4.execute-api.sa-east-1.amazonaws.com/participants/transfer-ticket"
headers = {
    "x-api-key": "YOUR_API_KEY",
    "x-api-secret": "YOUR_API_SECRET",
    "x-fingerprint-id": "928371",
}
payload = {
    "ticketId": "11111111-2222-3333-4444-555555555555",
    "fromParticipant": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
    "toParticipant": "ffffffff-1111-2222-3333-444444444444",
}

response = requests.patch(url, headers=headers, json=payload)
print(response.json())

Response

{
  "statusCode": 200,
  "data": {
    "transferred": true
  }
}

{
  "message": "Invalid param: []",
  "error": "Bad Request",
  "statusCode": 400,
  "errorCode": "string"
}

Generated from the schema

{
  "message": "Unauthorized",
  "error": "Unauthorized",
  "statusCode": 401
}

Generated from the schema

{
  "message": "Forbidden resource",
  "error": "Forbidden",
  "statusCode": 403
}

Generated from the schema

{
  "statusCode": 500,
  "message": "Internal Server Error"
}

Generated from the schema