# Dentai Developer Platform

> Dentai is a dental referral platform in Israel. Three kinds of partner integrate with its API. A practice-management system (PMS) hands a patient over to Dentai's referral form, receives signed webhooks about what happens to the referral, and polls a reconciliation feed. A clinic or a chain of clinics creates referrals from its own software, and nobody opens Dentai. An imaging institute (X-ray centre) receives referrals instead: it polls the feed for referrals clinics sent it, and delivers the scans — by upload, or by giving Dentai a URL to fetch. The pages of this site are a JavaScript app; the files below are the same documentation as plain text.

If you are a coding agent, start with the build brief for your side — PMS, clinic or chain, or imaging institute — and follow it in order. It tells you what to ask the human for before you write any code, and it checks your work after every step. The three briefs describe the same API in the order each side calls it; following the wrong one leads to a step that is not yours.

## Build an integration

- [Build brief for coding agents — practice-management systems](https://developers.dentai.co.il/agent-brief.md): the integration as a step-by-step build order, with a verification gate after every step. Start here if your product sends referrals.
- [Build brief for coding agents — imaging institutes](https://developers.dentai.co.il/institute-brief.md): the same, for an X-ray centre or network that receives referrals, polls the feed for work, and either uploads the scans or hands Dentai a URL to download them from. Its branches and the services each one performs are set up in Dentai by us before it is given a credential, so this side administers nothing. Start here if your product performs imaging.
- [Build brief for coding agents — clinics and chains](https://developers.dentai.co.il/clinic-brief.md): for a clinic or chain whose own software creates the referral: create the patient, create the referral with a destination, and hear what happened. Start here if your own clinics send referrals and your staff should not open Dentai.
- [Integration guide](https://developers.dentai.co.il/integration-guide.md): the full reference behind the brief: authentication, the referral handoff, webhooks and signature verification, images, delivery semantics, error codes.

## Contract

- [OpenAPI specification](https://developers.dentai.co.il/openapi.json): every partner endpoint with its request and response schemas, as OpenAPI 3 JSON.
- [Changelog](https://developers.dentai.co.il/changelog.json): contract versions and what changed in each, as JSON.

## Optional

- [Sandbox Postman collection](https://developers.dentai.co.il/dentai-sandbox.postman_collection.json): ready-made requests against the Sandbox.

Both sides use the same OpenAPI specification; there is one contract, not two.