This article describes the steps for retrieving a subscription in BlueDolphin.
HTTP response status code | Interpretation |
200 OK | Subscription retrieved successfully |
400 Bad Request | Subscription could not be retrieved due to invalid tenant data passed |
401 Unauthorized | Subscription could not be retrieved due to the user not being authorized with the correct API key |
404 Not Found | Could not find subscription with specified ID |
500 Internal Server Error | The subscriptions couldn’t be retrieved due to a server error |
Make a GET request to /subscriptions/{id}:
Resource/endpoint destination URL
The header for your API request
The {tenant} needs to be replaced with the tenant's name
The ID needs to be replaced with the ID of the subscription to retrieve
curl --location --globoff --request GET
'https://public-api.eu.bluedolphin.app/v1/subscriptions/‘{id} \
--header 'x-api-key: YOURAPIKEYSECRET' \
--header 'tenant: tenantName' \
Successful response
A successful call returns a response with a 200 OK HTTP status code and the following body:
{
"id": "Unique identifier",
"last_updated_by": "Unique identifier",
"url": "Unique URL provided",
"bluedolphin_event": "Event Name",
"object_definition_id": "000000000000000000000001",
"workspace_id": "000000000000000000000001",
"headers": {},
"status": 0,
"http_verb": "POST"
}Response properties
Property | Type | Description |
id | string | Unique identifier for the subscription |
last_updated_by | string | Unique identifier of the person who last updated/created the subscription |
url | string | The external URL to which messages are sent |
bluedolphin_event | string | The event name for which the subscription was created |
object_definition_id | string | Unique identifier of the object definition that the object is based on |
workspace_id | string | Unique identifier of the workspace where the event is located |
headers | object | The headers are provided, if needed, to make a request to an external URL with authorization tokens |
http_verb | string | The type of request to be made to the URL provided |