Video Consultation Service 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://api.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
GET /specialities
List of available specialities under sanar.
02
GET /doctors
Return speciality doctors list.
03
GET /slots
Return doctor information and available slots for 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
/specialities	GET	No	List of specialities available
/doctors	GET	No	Get list of doctors for a speciality.
/slots	GET	No	Get doctor information and available slots for a date.
/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.