Salt la conținutul principal
Aniva Partner API este un API REST care le permite partenerilor din domeniul medical să gestioneze profilurile pacienților, să facă programări de recoltare de sânge în locațiile de testare și să inițieze fluxurile de comenzi de laborator. Interacționezi cu API-ul prin HTTPS folosind cheia ta API de partener.

Ce poți face

  • Gestionarea profilurilor — Creează, preia și actualizează profilurile demografice ale pacienților.
  • Stabilirea programărilor — Fă programări pentru recoltare de sânge în locațiile de testare Aniva.
  • Gestionarea panelurilor — Adaugă sau elimină paneluri de analize de laborator la o programare existentă.
  • Biomarkeri individuali — Atașează sau elimină biomarkeri individuali la o programare, fără a alege un panel.
  • Comenzi de kituri de testare la domiciliu — Trimite un kit de testare la domiciliu unui pacient, urmărește coletele și raportează când a fost colectată proba.
  • Catalog de paneluri — Răsfoiește panelurile disponibile cu GET /api/v1/panels pentru a afla ID-urile panelurilor și biomarkerii incluși în fiecare.
  • Catalog de biomarkeri — Răsfoiește biomarkerii pe care îi poți comanda într-o locație sau într-un kit de testare la domiciliu cu GET /api/v1/biomarkers pentru a le afla ID-urile.
  • Confirmarea recoltării de sânge — Trimite codul sau codurile de laborator după o recoltare de sânge pentru a iniția fluxul de comenzi de laborator.
  • Rezultate de laborator — Preia rezultatele clinice și genetice și descarcă rapoartele de laborator în format PDF.
  • Găsirea locațiilor — Listează locațiile de testare disponibile pentru a le afișa pacienților.
  • Logistica expedierilor — Creează, urmărește, modifică și anulează comenzi de expediere prin curier.
  • Webhooks — Primește un apel HTTPS când se modifică o programare, o comandă de kit de testare la domiciliu, rezultatele acesteia, o locație, un profil sau o expediere. Vezi Webhooks.

Explorează documentația

Autentificare

Autentifică cererile cu cheia ta API de partener.

Start rapid

Fă primul tău apel API în câteva minute cu exemple pas cu pas.

Profiluri

Află cum funcționează profilurile pacienților și ce date conțin.

Programări

Înțelege ciclul de viață al programării, de la stabilire la confirmare.

Comenzi de kituri de testare la domiciliu

Trimite un kit de testare la domiciliul unui pacient și urmărește-l până când proba ajunge la laborator.

Versionarea API-ului

Versiunea curentă a API-ului este v1. Toate endpoint-urile au prefixul /api/v1/. URL-ul de bază este https://anivahealth.com.
Modificările care afectează compatibilitatea vor fi introduse sub un nou prefix de versiune. API-ul v1 va rămâne disponibil, cu notificare prealabilă pentru orice retragere din uz.

Date și fusuri orare

Toate momentele transmise prin rețea sunt în format UTC ISO 8601 (sufix Z). Câmpurile strict calendaristice folosesc componente de dată/oră locală (YYYY-MM-DD, HH:MM). Note specifice:
  • Câmpurile de intrare care acceptă o dată cu oră (de ex. scheduled_at la POST / PATCH /api/v1/appointments) trebuie să includă un indicator de fus orar — fie Z, fie un decalaj explicit precum +02:00. Valorile fără fus orar sunt respinse cu 400. Ambele forme codifică același moment; răspunsul returnează întotdeauna scheduled_at în format UTC Z. Folosește câmpul timezone al locației (sau orice alt identificator IANA) pentru a formata momentul în ora locală la afișare.
  • Intrările de dată/oră locală sunt interpretate în fusul orar al resursei vizate: datele de disponibilitate folosesc parametrul de interogare timezone (implicit fusul orar al locației); câmpurile pickup_date / pickup_time_* ale expedierii sunt interpretate în fusul orar al locației de origine.
  • Câmpurile de răspuns doar cu dată (de ex. tested_at, availability[].date din disponibilitate) sunt date calendaristice fără fus orar.

Obținerea accesului

Cheile API sunt emise de Aniva pentru fiecare partener.
Contactează Aniva pentru a primi cheia ta API de partener.