| Table of Contents |
|---|
Introduction
To obtain a list of insurance products, the Thinksurance Public API V1 (referred to as "the API") provides a dedicated endpoint designed specifically for this purpose. This endpoint enables consumers to retrieve either the complete list of insurance products or filter them based on the profession.
Endpoint
To retrieve products, consumers are required to send an HTTP POST request to the /api/products endpoint. This endpoint requires the security token, obtained during the Authentication process on the API, as an integral component of the JSON payload within the body of the request. Additionally, should there be a necessity to filter products by professions, an optional attribute, professionId, can be included as part of the JSON payload.
Action name | get products |
|---|---|
HTTP path | /api/products |
HTTP method | POST |
Attributes of the HTTP request
token | string | required | A security token provided from Authentication endpoint. |
|---|---|---|---|
professionId | int | optional | An attribute used to filter out all products for particular profession. |
Attributes of the HTTP response
Success response | |||
|---|---|---|---|
JSON array of objects containing: | |||
id | int | required | An unique identifier of the product. |
name | string | required | A product’s name. |
Failed response | |||
error | string | required | It contains a reason for the failed request. |
Examples
This section shows examples of different HTTP requests and responses associated with the endpoint /api/products.
...