probatix
Developer · REST API

L'API per la diagnostica di laboratorio: ordinare, tracciare, ricevere referti

L'API Probatix è un'interfaccia REST che copre l'intero workflow diagnostico: ordinare kit di test, seguire gli stati di logistica e laboratorio tramite webhook e ricevere referti come bundle FHIR R4 con valori codificati LOINC. Una sola integrazione – dall'ordine del kit al risultato strutturato.

REST FHIR R4 LOINC Webhook <48h time-to-result
Prenota una demo Come funziona un'integrazione
Il processo

Come funziona un'integrazione

Quattro passi, un flusso di dati: il Suo sistema parla esclusivamente con l'API Probatix – fulfillment, laboratori e logica dei referti restano nascosti dietro di essa.

01

Creare l'ordine

Il Suo sistema crea un ordine di test con una chiamata REST – con variante del kit, panel e indirizzo di spedizione. Probatix valida i dati obbligatori e avvia il fulfillment.

REST JSON
02

Ricevere gli eventi logistici

Spedizione, consegna, rispedizione del campione e accettazione in laboratorio: ogni passaggio di stato viene notificato al Suo sistema come webhook – senza polling.

Webhook Tracking
03

Ricevere il webhook dei risultati

Non appena il referto è validato dal medico, un webhook notifica il Suo sistema in tempo reale. Decide Lei quando e come informare l'utente finale.

Tempo reale Event-based
04

Recuperare il referto

Il referto è disponibile come JSON strutturato o come bundle FHIR R4 – DiagnosticReport e Observation, codificati LOINC, con intervalli di riferimento.

FHIR R4 LOINC
FHIR R4

Ecco come appare un referto

Esempio abbreviato e generico di un referto FHIR R4: un DiagnosticReport con Observation codificata LOINC, incluso l'intervallo di riferimento. I referti reali contengono inoltre dati Specimen e tutti i parametri del panel. 

{
  "resourceType": "DiagnosticReport",
  "status": "final",
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "24331-1",
      "display": "Lipid 1996 panel - Serum or Plasma"
    }]
  },
  "issued": "2026-08-04T09:30:00+02:00",
  "result": [
    { "reference": "Observation/obs-ldl-example" }
  ]
}

{
  "resourceType": "Observation",
  "id": "obs-ldl-example",
  "status": "final",
  "code": {
    "coding": [{
      "system": "http://loinc.org",
      "code": "13457-7",
      "display": "Cholesterol in LDL [Mass/volume] in Serum or Plasma by calculation"
    }]
  },
  "valueQuantity": {
    "value": 118,
    "unit": "mg/dL",
    "system": "http://unitsofmeasure.org",
    "code": "mg/dL"
  },
  "referenceRange": [{
    "high": { "value": 116, "unit": "mg/dL" }
  }]
}

Autenticazione

L'accesso all'API avviene tramite credenziali personalizzate che riceve nell'onboarding. Tutti gli endpoint sono raggiungibili esclusivamente in forma cifrata via TLS; gli accessi sono separati per tenant e registrati in modo auditabile.

Documentazione & sandbox

Riferimento API completo, ambiente di test e referti di esempio vengono messi a disposizione dei partner nell'onboarding. La via più rapida: un colloquio demo con il nostro team.

Prenoti una demo e richieda l'accesso API

Approfondimento nel Centro conoscenze

Come REST, referto FHIR e LOINC interagiscono nell'integrazione quotidiana lo mostra l'articolo Integrare la diagnostica di laboratorio tramite API – inclusi esempi di workflow per telemedicina e health app. Per la visione d'insieme: la piattaforma Probatix e la guida DaaS.

Domande frequenti

API di diagnostica: FAQ

Le quattro domande che i team di sviluppo pongono più spesso prima di un'integrazione.

Quale versione di FHIR è supportata?
I referti vengono consegnati come bundle FHIR R4 – con DiagnosticReport, Observation e Specimen come risorse centrali. I parametri sono codificati LOINC, le unità seguono UCUM. Per i sistemi senza connessione FHIR lo stesso referto è disponibile come JSON strutturato.

Ci sono webhook per i passaggi di stato?
Sì. Tutti i passaggi di stato rilevanti – dalla creazione dell'ordine alla spedizione e all'accettazione del campione fino alla validazione del referto – attivano webhook. Il Suo sistema resta sincronizzato in tempo reale, senza dover interrogare periodicamente l'API.

Quanto velocemente sono disponibili i risultati?
Per la maggior parte dei test il risultato è disponibile entro 48 ore dall'accettazione del campione in laboratorio. Il webhook dei risultati scatta immediatamente dopo la validazione medica del referto.

Esiste un ambiente di test?
Sì. Per la fase di integrazione mettiamo a disposizione un ambiente di test in cui simulare ordini, passaggi di stato e referti di esempio, senza che vengano spediti kit reali. L'accesso viene fornito durante l'onboarding – prenoti una demo a questo scopo.

Una API. L'intero workflow diagnostico.

Deep dive tecnico con il nostro team: architettura, payload di esempio e accesso sandbox per il Suo caso d'uso.

Prenota una demo Alla panoramica white-label