channels-teladoc-callbacks-b2b-xapi

Overview

The channels-teladoc-callbakcs-b2b-xapi provides a REST interface that allows the consumer to send requests to Fidelidade when an event occurs in Teladoc.

For more information on each of these functionalities, please refer to the description of each resource on the left navigation panel.

Consumers

B2B_Teladoc

Use Cases

Send Event

• POST: /events
• Request to inform/confirm an Event

Communication

This section indicates how the connection with the API is achieved and regarding the output of the same.

Security

The communication with the API is performed over HTTPS, meaning that the communication is encrypted, providing an additional layer of protection when transporting your information.

Moreover, all requests are performed applying a Client ID Enforcement policy, enabling only authorized consumers to access the API resources.

SLA Tiers

The Standard SLA tier allows you to perform up to X requests per minute on the resources of this API.

If your needs exceed these limits, please contact Fidelidade to negotiate access to a higher SLA tier.

Error Handling

Successful requests to the API will return a 2xx status code.

When an error occurs, the API will respond with a status code in the 4xx or 5xx group, enforcing the standard HTTP status codes.

As for the error structure, the API uses a standard structure, that contains the details of the error itself.

Consumers can use the details present in this standard structure to help troubleshoot errors.

In particular, the correlationId can be used by Fidelidade to internally identify the request chain that caused the error.

The following is an example of said structure:

application/json
{
"errorCode": 500,
"correlationId": "8a9cd990-4888-11ec-8f20-005056b5e555",
"timeStamp": "2021-11-18T15:59:42Z",
"description": "The description of the error",
"detailedDescription": "Further details of the error",
"externalError": ""
}