API РЕСУРСЫ

Lead & CRM

Келіп түскен өтінімдерді (lead) бір қорда жинаңыз; тапсырманы, қоңырауды және науқаспен байланысты қадағалаңыз. Ешбір қызығушылық жолда жоғалмасын.

Ерте Қатынау Барлық API

Ұштар

7 ұш

Бұл ресурсқа тиесілі ұштар. Әр ұш API кілті байланысты клиника дерегімен шектелген; жазу ұштары Idempotency-Key тақырыпшасын қолдайды.

GET /v1/leads Lead/өтінімдерді тізімдейді Өкілетті пайдаланушы

POST /v1/leads Жаңа lead жасайды Өкілетті пайдаланушы

POST /v1/leads/{id}/status Lead жай-күйін/кезеңін өзгертеді Өкілетті пайдаланушы

GET /v1/tasks Тапсырмаларды тізімдейді Өкілетті пайдаланушы

POST /v1/tasks Тапсырма жасайды Өкілетті пайдаланушы

GET /v1/messages Науқаспен байланыс хабарламаларын тізімдейді Өкілетті пайдаланушы

POST /v1/messages Хабарлама/байланыс жазбасын жасайды Өкілетті пайдаланушы

Қолдану Мысалы

Lead жай-күйін жаңарту

Сұраныс

curl -X POST https://api.udentiva.com/v1/leads/{id}/status \
  -H "Authorization: Bearer udk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"status":"qualified"}'

Жауап

HTTP/1.1 200 OK
{
  "id": "ld-88",
  "status": "qualified"
}

Бұл ресурстағы қауіпсіздік

Қауіпсіздік — мүмкіндік емес, сәулеттің өзі. Бұл ресурста қолданылатын кепілдіктер:

Lead және байланыс жазбалары клиникаңызға оқшауланған (RLS).

Public lead қабылдау (landing) бөлек, сессиясыз және жылдамдығы шектелген ұш болып табылады; спам Redis терезе шегімен болдырылмайды.

Бүкіл қауіпсіздік моделі →

Қате Форматы

Қателер тұрақты конвертпен қайтарылады; код машинаға, хабар қолданушыға арналған. Ішкі қате/стек ешқашан сызылмайды.

{
  "error": {
    "code": "validation_failed",
    "message": "Жарамсыз өріс: электрондық пошта"
  }
}

Басқа Ресурстар

Науқастар Қабылдау & Күнтізбе Одонтограмма & Емдеу Төлем және Қаржы Қор Бейнелеу Зертхана Медициналық туризм Есеп беру & BI Webhooks Деректерді Тасымалдау (Export API)

Ерте қатынау қалайсыз ба?

API ашылғанда алдымен сіз хабардар болыңыз.

Байланысу