What are the Haptik API Requisites

The main objective of this document is to highlight the requirements for APIs that are made available to Haptik for the development of an Intelligent Virtual Agent (IVA). Haptik will consume API endpoints in scenarios where data needs to be fetched and presented to the end-user.

Pre-requisites for consuming the APIs for development purposes

• All APIs should preferably be Restful APIs that use HTTP requests to GET, PUT, POST, and DELETE data.
• API documentation containing clear instructions about how to effectively use and integrate with the API endpoint. 
• The document should explain the various API endpoints, how to construct requests, and what to expect as a response.
  • Each endpoint should contain the following details:
    • Endpoint URL.
    • The path to call each endpoint.
    • Which HTTP methods can be used with each endpoint.
    • Authentication and other headers are required with each request.
    • Explanation of what request data is mandatory and what is optional.
    • Example Request Body.
    • Example Response Body.
    • Possible Error Scenarios and Status Codes.
    • If there is authentication, please provide authentication steps in detail.
• Request and Response must be JSON preferably.
• API endpoints must be publicly accessible.
  • In case they are not publicly accessible, Haptik’s IPs must be whitelisted.
• APIs should have a stable Staging/Test environment that can be used during development.
• Any test accounts/IDs as applicable - for eg. dummy mobile numbers, sample user IDs, sample tracking IDs, etc that can be used to test out the APIs should be available.

Required API Details for Testing