Kids Vaccination API Documentation

This revamp removes visual clutter and keeps only the information integration teams need: authentication rules, endpoint flow, request and response payload examples, and status handling.

Base URL: https://extct.litedev.com/v1

Protocol: HTTPS + JSON

Flow: 4 ordered endpoints

Auth: Authorization + Cmt

Booking Flow

Calls must happen in order because each step provides identifiers required by the next call.

01
POST /services
List available services under partner product code.
02
POST /details
Return service details, inclusions, and instructions.
03
POST /browse
Return providers and available slots for location/date.
04
POST /book
Create booking and return payment URL.

Authentication and Headers

Browse and booking endpoints require both Authorization and Cmt headers. All requests must use Content-Type: application/json.

Header	Required For	Notes
Authorization	Browse, Book	Partner token issued by Sanar. Keep server-side.
Cmt	Browse, Book	Request-bound signature derived from payload and partner secret.
Content-Type	All endpoints	Must be application/json.

Example tokens are intentionally omitted from this cleaned document to avoid accidental reuse or leakage.

Endpoints at a Glance

Endpoint	Method	Auth	Purpose
/services	POST	No	List services available for a product code (prd_id).
/details	POST	No	Get service details by id and prd_id.
/browse	POST	Yes	Get providers and slots using date, location, and services.
/book	POST	Yes	Create booking and receive booking_id + payment_url.

API Samples

Request and response examples for all four endpoints.

Loading samples...

Status and Error Handling

Always evaluate response body status first, then HTTP status.

Code	Meaning	Expected Client Action
1000	Success	Render data and continue flow.
1001	Validation error	Fix payload fields and retry.
1002	Unauthorized	Refresh Authorization token.
1003	Signature mismatch	Recalculate Cmt and retry once.
1004	Not found	Refresh previous step data.
1005	Slot unavailable	Ask user to select another slot.
5000	Server error	Retry with backoff, then escalate support.