Demande API

Introduction

L’API U-Santé est une API REST sécurisée permettant aux centres de santé d’enregistrer leurs données médicales et aux patients d’y accéder via nos applications mobiles.

API REST sécurisée – Format JSON – Authentification via Bearer Token

Connexion au Backoffice Client

Cette URL correspond à une page web sécurisée permettant au centre de santé d'accéder à son tableau de bord.

🧪 Test


                            https://test.usante.unitechnology.pro/client/login
                        

🚀 Production


                            https://api.usante.unitechnology.pro/client/login
                        
Cette page n'est PAS une API REST. Elle permet d'accéder aux statistiques et à la gestion du compte.
  • 📊 Voir les statistiques
  • 👤 Modifier ses informations personnelles
  • 🏥 Modifier les informations du centre
  • 🔑 Consulter la clé API
  • 📁 Gérer les patients

Environnements API REST

🧪 Test


                            https://test.usante.unitechnology.pro/v1/clients                                
                        

🚀 Production


                            https://api.usante.unitechnology.pro/v1/clients
                        
Toujours tester en environnement TEST avant de passer en production.

Créer un Patient

Cet endpoint permet d’enregistrer un patient dans votre centre de santé. Chaque patient est automatiquement rattaché à la société associée à votre API Key.

⚠️ Le numero_patient doit être unique pour chaque patient.

POST /patients

                        https://api.usante.unitechnology.pro/v1/clients/patients
                    

                        https://test.usante.unitechnology.pro/v1/clients/patients
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Content-Type: application/json
                        Accept: application/json
                    

Body JSON


                    {
                        "patientData": {
                            "numero_patient": "PAT-00125",
                            "id": "INT-4587",
                            "nom": "KOUADIO",
                            "prenoms": "Jean Michel",
                            "date_naissance": "1990-05-12",
                            "lieu_naissance": "Abidjan",
                            "telephone": "+2250700000000",
                            "email": "jean@email.com",
                            "sexe": "1",
                            "nationalite": "Ivoirienne",
                            "ethnie": "Baoulé",
                            "lieu_habitation": "Cocody",
                            "numero_cmu": "CMU-548965",
                            "numero_piece": "CNI-45879632",
                            "genre": "Adulte",
                            "groupe_sanguin": "O+",

                            "nom_prenoms_pere": "KOUADIO Paul",
                            "date_naissance_pere": "1965-08-15",
                            "lieu_naissance_pere": "Bouaké",
                            "telephone_pere": "+2250100000000",
                            "nationalite_pere": "Ivoirienne",
                            "ethnie_pere": "Baoulé",
                            "lieu_habitation_pere": "Yamoussoukro",

                            "nom_prenoms_mere": "AMOIN Marie",
                            "date_naissance_mere": "1970-03-10",
                            "lieu_naissance_mere": "Daloa",
                            "telephone_mere": "+2250500000000",
                            "nationalite_mere": "Ivoirienne",
                            "ethnie_mere": "Bété",
                            "lieu_habitation_mere": "Abobo"
                        }
                    }
                    

Description complète des Champs

Champ Type Obligatoire Description
numero_patient string (100) Oui Identifiant unique du patient
id string (30) Oui Identifiant interne
nom string (255) Oui Nom du patient
prenoms string (255) Oui Prénoms du patient
date_naissance date (YYYY-MM-DD) Oui Date de naissance
lieu_naissance string Oui Lieu de naissance
telephone string (30) Non Téléphone du patient
email email Non Adresse email valide
sexe 0 ou 1 Oui 0 = Masculin, 1 = Féminin
nationalite string Non Nationalité du patient
ethnie string Non Ethnie du patient
lieu_habitation string Non Adresse du patient
numero_cmu string Non Numéro CMU
numero_piece string Non Numéro pièce d’identité
genre string Non Catégorie patient (auto-créée si inexistante)
groupe_sanguin string Non Groupe sanguin (auto-créé si inexistant)
nom_prenoms_pere string Non Nom et prénoms du père
date_naissance_pere date Non Date de naissance du père
lieu_naissance_pere string Non Lieu de naissance du père
telephone_pere string Non Téléphone du père
nationalite_pere string Non Nationalité du père
ethnie_pere string Non Ethnie du père
lieu_habitation_pere string Non Adresse du père
nom_prenoms_mere string Non Nom et prénoms de la mère
date_naissance_mere date Non Date de naissance de la mère
lieu_naissance_mere string Non Lieu de naissance de la mère
telephone_mere string Non Téléphone de la mère
nationalite_mere string Non Nationalité de la mère
ethnie_mere string Non Ethnie de la mère
lieu_habitation_mere string Non Adresse de la mère

Réponse Succès (201)

{
                            "success": true,
                            "message": "Patient enregistré avec succès",
                            "data": {
                                "id": "INT-4587",
                                "numero_patient": "PAT-00125"
                            }
                            }

Patient déjà existant (409)

{
                            "success": false,
                            "message": "Ce patient est déjà enregistré"
                            }

Erreur de validation (422)

{
                            "success": false,
                            "message": "Erreur de validation",
                            "errors": {
                                "patientData.nom": [
                                "Le nom du patient est obligatoire."
                                ]
                            }
                            }

Mettre à jour un Patient

Cet endpoint permet de mettre à jour les informations d’un patient existant. Il faut fournir le numero_patient dans l’URL. Seuls les champs présents dans le body seront mis à jour ; les autres resteront inchangés.

PUT /patients/code/{patientCode}

                        https://api.usante.unitechnology.pro/v1/clients/patients/code/PAT-00125
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY 
                        Content-Type: application/json
                        Accept: application/json
                    

Body JSON


                    {
                        "patientData": {
                            "id": "INT-4587",
                            "nom": "KOUADIO",
                            "prenoms": "Jean Michel",
                            "date_naissance": "1990-05-12",
                            "lieu_naissance": "Abidjan",
                            "telephone": "+2250700000000",
                            "email": "jean@email.com",
                            "sexe": "1",
                            "nationalite": "Ivoirienne",
                            "ethnie": "Baoulé",
                            "lieu_habitation": "Cocody",
                            "numero_cmu": "CMU-548965",
                            "numero_piece": "CNI-45879632",
                            "genre": "Adulte",
                            "groupe_sanguin": "O+",

                            "nom_prenoms_pere": "KOUADIO Paul",
                            "date_naissance_pere": "1965-08-15",
                            "lieu_naissance_pere": "Bouaké",
                            "telephone_pere": "+2250100000000",
                            "nationalite_pere": "Ivoirienne",
                            "ethnie_pere": "Baoulé",
                            "lieu_habitation_pere": "Yamoussoukro",

                            "nom_prenoms_mere": "AMOIN Marie",
                            "date_naissance_mere": "1970-03-10",
                            "lieu_naissance_mere": "Daloa",
                            "telephone_mere": "+2250500000000",
                            "nationalite_mere": "Ivoirienne",
                            "ethnie_mere": "Bété",
                            "lieu_habitation_mere": "Abobo"
                        }
                    }
                    

Description complète des Champs

Champ Type Obligatoire Description
id string (30) Non Identifiant interne du patient
nom string (255) Non Nom du patient
prenoms string (255) Non Prénoms du patient
date_naissance date Non Date de naissance
lieu_naissance string Non Lieu de naissance
telephone string (30) Non Téléphone du patient
email email Non Adresse email
sexe 0 ou 1 Non 0 = Féminin, 1 = Masculin
nationalite string Non Nationalité du patient
ethnie string Non Ethnie du patient
lieu_habitation string Non Adresse du patient
numero_cmu string Non Numéro CMU
numero_piece string Non Numéro pièce d’identité
genre string Non Catégorie du patient (ex : Adulte)
groupe_sanguin string Non Groupe sanguin
nom_prenoms_pere string Non Nom et prénoms du père
date_naissance_pere date Non Date de naissance du père
lieu_naissance_pere string Non Lieu de naissance du père
telephone_pere string Non Téléphone du père
nationalite_pere string Non Nationalité du père
ethnie_pere string Non Ethnie du père
lieu_habitation_pere string Non Adresse du père
nom_prenoms_mere string Non Nom et prénoms de la mère
date_naissance_mere date Non Date de naissance de la mère
lieu_naissance_mere string Non Lieu de naissance de la mère
telephone_mere string Non Téléphone de la mère
nationalite_mere string Non Nationalité de la mère
ethnie_mere string Non Ethnie de la mère
lieu_habitation_mere string Non Adresse de la mère

Réponse Succès (200)

{
                        "success": true,
                        "message": "Patient mis à jour avec succès",
                        "data": {
                            "id": "INT-4587",
                            "numero_patient": "PAT-00125"
                        }
                        }

Patient non trouvé (404)

{
                        "success": false,
                        "message": "Patient introuvable"
                        }

Erreur de validation (422)

{
                        "success": false,
                        "message": "Erreur de validation",
                        "errors": {
                            "patientData.nom": [
                            "Le nom du patient doit être une chaîne de caractères."
                            ]
                        }
                        }

Lister les Patients

Cet endpoint permet de récupérer la liste des patients d'un client API. La liste est paginée et peut être filtrée par numero_patient ou nom.

GET /patients

                        https://api.usante.unitechnology.pro/v1/clients/patients?per_page=20&nom=Jean
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Accept: application/json
                    

Paramètres de requête (Query Params)

Paramètre Type Obligatoire Description
per_page integer Non Nombre de patients par page (max 100, défaut 20)
numero_patient string Non Filtrer par numéro du patient exact
nom string Non Filtrer par nom du patient (recherche partielle)

Réponse Succès (200)

{
                        "success": true,
                        "message": "Liste des patients",
                        "data": [
                            {
                            "id": "INT-4587",
                            "numero_patient": "PAT-00125",
                            "nom": "KOUADIO",
                            "prenoms": "Jean Michel",
                            "date_naissance": "1990-05-12",
                            "lieu_naissance": "Abidjan",
                            "telephone": "+2250700000000",
                            "email": "jean@email.com",
                            "sexe": "1",
                            "nationalite": "Ivoirienne",
                            "ethnie": "Baoulé",
                            "lieu_habitation": "Cocody",
                            "numero_cmu": "CMU-548965",
                            "numero_piece": "CNI-45879632",
                            "genre": "Adulte",
                            "groupe_sanguin": "O+"
                            },
                            {
                            "id": "INT-4588",
                            "numero_patient": "PAT-00126",
                            "nom": "DIOP",
                            "prenoms": "Fatou",
                            "date_naissance": "1985-11-25",
                            "lieu_naissance": "Bouaké",
                            "telephone": "+2250701111111",
                            "email": "fatou@email.com",
                            "sexe": "0",
                            "nationalite": "Ivoirienne",
                            "ethnie": "Bété",
                            "lieu_habitation": "Marcory",
                            "numero_cmu": "CMU-548966",
                            "numero_piece": "CNI-45879633",
                            "genre": "Adulte",
                            "groupe_sanguin": "A+"
                            }
                        ],
                        "meta": {
                            "current_page": 1,
                            "last_page": 5,
                            "per_page": 20,
                            "total": 100
                        }
                        }

Afficher les informations d'un Patient

Cet endpoint permet de récupérer les informations détaillées d'un patient spécifique en utilisant son numero_patient.

GET /patients/code/{patientCode}

                        https://api.usante.unitechnology.pro/v1/clients/patients/code/PAT-00125
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Accept: application/json
                    

Paramètres d'URL

Paramètre Type Obligatoire Description
patientCode string Oui Le numéro du patient à afficher

Réponse Succès (200)

{
                        "success": true,
                        "message": "Détails du patient",
                        "data": {
                            "id": "INT-4587",
                            "numero_patient": "PAT-00125",
                            "nom": "KOUADIO",
                            "prenoms": "Jean Michel",
                            "date_naissance": "1990-05-12",
                            "lieu_naissance": "Abidjan",
                            "telephone": "+2250700000000",
                            "email": "jean@email.com",
                            "sexe": "1",
                            "nationalite": "Ivoirienne",
                            "ethnie": "Baoulé",
                            "lieu_habitation": "Cocody",
                            "numero_cmu": "CMU-548965",
                            "numero_piece": "CNI-45879632",
                            "genre": "Adulte",
                            "groupe_sanguin": "O+",
                            "nom_prenoms_pere": "KOUADIO Paul",
                            "date_naissance_pere": "1965-03-10",
                            "lieu_naissance_pere": "Bouaké",
                            "telephone_pere": "+2250701111111",
                            "nationalite_pere": "Ivoirienne",
                            "ethnie_pere": "Baoulé",
                            "lieu_habitation_pere": "Abobo",
                            "nom_prenoms_mere": "KOUADIO Awa",
                            "date_naissance_mere": "1967-08-22",
                            "lieu_naissance_mere": "Yamoussoukro",
                            "telephone_mere": "+2250702222222",
                            "nationalite_mere": "Ivoirienne",
                            "ethnie_mere": "Baoulé",
                            "lieu_habitation_mere": "Cocody"
                        }
                        }

Créer un Reçu de Caisse pour un Patient

Cet endpoint permet d'enregistrer un reçu de caisse pour un patient spécifique, avec les détails des services et actes associés.

POST /patients/{patientCode}/receipts

                        https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/receipts
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Content-Type: application/json
                        Accept: application/json
                    

Paramètres d'URL

Paramètre Type Obligatoire Description
patientCode string Oui Le numéro du patient pour lequel le reçu sera créé

Body JSON


                    {
                        "recuData": {
                            "id": "REC-2026-001",
                            "numero_recu": "CAISSE-4587",
                            "date_recu": "2026-02-16",
                            "montant_total": 150000,
                            "net_a_payer": 150000,
                    
                            "servicesData": [
                                {
                                    "id": "SVC-001",
                                    "code_service": "CONSULT-01",
                                    "nom_service": "Consultation générale",
                                    "nom_responsable": "Dr. Koffi",
                                    "telephone_responsable": "+2250700000001",
                                    "service": true,
                                    "urgence": false,
                                    "pharmacie": false,
                                    "chirugie": false,
                                    "imagerie": false,
                                    "biologie": false,
                                    "gratuit_enfant": false,
                                    "gratuit_femme_enceinte": false,
                        
                                    "actesData": [
                                        {
                                            "id": "ACT-001",
                                            "code_acte": "ACT-CONS-01",
                                            "nom_acte": "Consultation adulte",
                                            "montant_acte": 150000,
                                            "montant_payer_patient": 150000,
                                            "net_a_payer_patient": 150000,
                                            "quantite_acte": 1,
                                            "certificat": false,
                                            "gratuit_enfant": false,
                                            "gratuit_femme_enceinte": false
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                    

Tableau des champs

Champ Type Obligatoire Description
recuData.id string Oui Identifiant unique du reçu
recuData.numero_recu string Oui Numéro du reçu de caisse
recuData.date_recu date Oui Date du reçu
recuData.montant_total numeric Oui Montant total du reçu
recuData.net_a_payer numeric Oui Montant net à payer par le patient
recuData.servicesData.*.id string Oui Identifiant unique du service
recuData.servicesData.*.code_service string Oui Code du service
recuData.servicesData.*.nom_service string Oui Nom du service
recuData.servicesData.*.nom_responsable string Non Nom du responsable du service
recuData.servicesData.*.telephone_responsable string Non Téléphone du responsable du service
recuData.servicesData.*.service boolean Oui Indique si c'est un service
recuData.servicesData.*.urgence boolean Oui Indique si le service est en urgence
recuData.servicesData.*.pharmacie boolean Oui Indique si le service implique la pharmacie
recuData.servicesData.*.chirugie boolean Oui Indique si le service est chirurgical
recuData.servicesData.*.imagerie boolean Oui Indique si le service inclut de l'imagerie
recuData.servicesData.*.biologie boolean Oui Indique si le service inclut de la biologie
recuData.servicesData.*.gratuit_enfant boolean Oui Indique si le service est gratuit pour les enfants
recuData.servicesData.*.gratuit_femme_enceinte boolean Oui Indique si le service est gratuit pour les femmes enceintes
recuData.servicesData.*.actesData.*.id string Oui Identifiant de l'acte
recuData.servicesData.*.actesData.*.code_acte string Oui Code de l'acte
recuData.servicesData.*.actesData.*.nom_acte string Oui Nom de l'acte
recuData.servicesData.*.actesData.*.montant_acte numeric Oui Montant de l'acte
recuData.servicesData.*.actesData.*.montant_payer_patient numeric Oui Montant payé par le patient pour cet acte
recuData.servicesData.*.actesData.*.net_a_payer_patient numeric Oui Montant net à payer par le patient
recuData.servicesData.*.actesData.*.quantite_acte numeric Oui Quantité de l'acte réalisé
recuData.servicesData.*.actesData.*.certificat boolean Oui Indique si un certificat est requis
recuData.servicesData.*.actesData.*.gratuit_enfant boolean Oui Indique si l'acte est gratuit pour les enfants
recuData.servicesData.*.actesData.*.gratuit_femme_enceinte boolean Oui Indique si l'acte est gratuit pour les femmes enceintes

Réponse Succès (201)

{
                        "success": true,
                        "message": "Reçu de caisse enregistré avec succès.",
                        "data": {
                            "id": "REC-2026-001",
                            "numero_patient": "PAT-00125"
                        }
                        }

Mettre à Jour un Reçu de Caisse pour un Patient

Cet endpoint permet de mettre à jour un reçu de caisse existant pour un patient, en remplaçant tous les services et actes associés.

PUT /patients/{patientCode}/receipts/{receiptId}

                        https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/receipts/REC-2026-001
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Content-Type: application/json
                        Accept: application/json
                    

Paramètres d'URL

Paramètre Type Obligatoire Description
patientCode string Oui Numéro du patient dont le reçu sera mis à jour
receiptId string Oui Identifiant du reçu à mettre à jour

Body JSON


                    {
                        "recuData": {
                            "id": "REC-2026-001",
                            "numero_recu": "CAISSE-4587",
                            "date_recu": "2026-02-16",
                            "montant_total": 150000,
                            "net_a_payer": 150000,
                            
                            "servicesData": [
                                {
                                    "id": "SVC-001",
                                    "code_service": "CONSULT-01",
                                    "nom_service": "Consultation générale",
                                    "nom_responsable": "Dr. Koffi",
                                    "telephone_responsable": "+2250700000001",
                                    "service": true,
                                    "urgence": false,
                                    "pharmacie": false,
                                    "chirugie": false,
                                    "imagerie": false,
                                    "biologie": false,
                                    "gratuit_enfant": false,
                                    "gratuit_femme_enceinte": false,
                            
                                    "actesData": [
                                        {
                                            "id": "ACT-001",
                                            "code_acte": "ACT-CONS-01",
                                            "nom_acte": "Consultation adulte",
                                            "montant_acte": 150000,
                                            "montant_payer_patient": 150000,
                                            "net_a_payer_patient": 150000,
                                            "quantite_acte": 1,
                                            "certificat": false,
                                            "gratuit_enfant": false,
                                            "gratuit_femme_enceinte": false
                                        }
                                    ]
                                }
                            ]
                        }
                    }
                    

Tableau des champs

Champ Type Obligatoire Description
recuData.id string Oui Identifiant unique du reçu
recuData.numero_recu string Oui Numéro du reçu de caisse
recuData.date_recu date Oui Date du reçu
recuData.montant_total numeric Oui Montant total du reçu
recuData.net_a_payer numeric Oui Montant net à payer par le patient
recuData.servicesData.*.id string Oui Identifiant unique du service
recuData.servicesData.*.code_service string Oui Code du service
recuData.servicesData.*.nom_service string Oui Nom du service
recuData.servicesData.*.nom_responsable string Non Nom du responsable du service
recuData.servicesData.*.telephone_responsable string Non Téléphone du responsable du service
recuData.servicesData.*.service boolean Oui Indique si c'est un service
recuData.servicesData.*.urgence boolean Oui Indique si le service est en urgence
recuData.servicesData.*.pharmacie boolean Oui Indique si le service implique la pharmacie
recuData.servicesData.*.chirugie boolean Oui Indique si le service est chirurgical
recuData.servicesData.*.imagerie boolean Oui Indique si le service inclut de l'imagerie
recuData.servicesData.*.biologie boolean Oui Indique si le service inclut de la biologie
recuData.servicesData.*.gratuit_enfant boolean Oui Indique si le service est gratuit pour les enfants
recuData.servicesData.*.gratuit_femme_enceinte boolean Oui Indique si le service est gratuit pour les femmes enceintes
recuData.servicesData.*.actesData.*.id string Oui Identifiant de l'acte
recuData.servicesData.*.actesData.*.code_acte string Oui Code de l'acte
recuData.servicesData.*.actesData.*.nom_acte string Oui Nom de l'acte
recuData.servicesData.*.actesData.*.montant_acte numeric Oui Montant de l'acte
recuData.servicesData.*.actesData.*.montant_payer_patient numeric Oui Montant payé par le patient pour cet acte
recuData.servicesData.*.actesData.*.net_a_payer_patient numeric Oui Montant net à payer par le patient
recuData.servicesData.*.actesData.*.quantite_acte numeric Oui Quantité de l'acte réalisé
recuData.servicesData.*.actesData.*.certificat boolean Oui Indique si un certificat est requis
recuData.servicesData.*.actesData.*.gratuit_enfant boolean Oui Indique si l'acte est gratuit pour les enfants
recuData.servicesData.*.actesData.*.gratuit_femme_enceinte boolean Oui Indique si l'acte est gratuit pour les femmes enceintes

Réponse Succès (200)

{
                        "success": true,
                        "message": "Reçu mis à jour avec succès",
                        "data": {
                            "id": "REC-2026-001",
                            "numero_patient": "PAT-00125"
                        }
                        }

Lister les Reçus de Caisse

Cet endpoint permet de récupérer la liste paginée des reçus de caisse associés au client API authentifié. Les résultats sont paginés et peuvent être filtrés par numéro de reçu.

GET /patients/receipts

                        https://api.usante.unitechnology.pro/v1/clients/patients/receipts?per_page=20&num_caiss=CAISSE-4587
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Accept: application/json
                    

Paramètres Query

Paramètre Type Obligatoire Description
per_page integer Non Nombre d'éléments par page (max 100, défaut 20)
num_caiss string Non Filtrer par numéro de reçu

Structure des données retournées

Champ Type Description
id string Identifiant du reçu (IDCAISSE)
numero_recu string Numéro du reçu de caisse
date_recu date Date du reçu
montant_total numeric Montant total du reçu
net_a_payer numeric Montant net à payer
services array Liste des services associés au reçu
services[].actes array Liste des actes liés au service

Réponse Succès (200)

{
                            "success": true,
                            "message": "Liste paginée des reçus de caisse",
                            "data": [
                                {
                                    "id": "REC-2026-001",
                                    "numero_recu": "CAISSE-4587",
                                    "date_recu": "2026-02-16",
                                    "montant_total": 150000,
                                    "net_a_payer": 150000,
                                    "services": [
                                        {
                                            "id": "SVC-001",
                                            "nom_service": "Consultation générale",
                                            "code_service": "CONSULT-01",
                                            "actes": [
                                                {
                                                "id": "ACT-001",
                                                "nom_acte": "Consultation adulte",
                                                "code_acte": "ACT-CONS-01",
                                                "montant_acte": 150000,
                                                "quantite_acte": 1,
                                                "net_a_payer_patient": 150000,
                                                "montant_payer_patient": 150000
                                                }
                                            ]
                                        }
                                    ]
                                }
                            ],
                            "meta": {
                                "current_page": 1,
                                "last_page": 5,
                                "per_page": 20,
                                "total": 95
                            }
                            }

Lister les Reçus d’un Patient

Cet endpoint permet de récupérer la liste paginée des reçus de caisse d’un patient spécifique identifié par son numero_patient.

GET /patients/{patientCode}/receipts

                        https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/receipts?per_page=20&num_caiss=CAISSE-4587
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Accept: application/json
                    

Paramètres d'URL

Paramètre Type Obligatoire Description
patientCode string Oui Numéro du patient dont on veut lister les reçus

Paramètres Query

Paramètre Type Obligatoire Description
per_page integer Non Nombre d’éléments par page (max 100, défaut 20)
num_caiss string Non Filtrer par numéro de reçu

Structure des données retournées

Champ Type Description
id string Identifiant du reçu (IDCAISSE)
numero_recu string Numéro du reçu
date_recu date Date du reçu
montant_total numeric Montant total du reçu
net_a_payer numeric Montant net à payer
services array Liste des services associés au reçu
services[].actes array Liste des actes associés au service

Réponse Succès (200)

{
                            "success": true,
                            "message": "Liste paginée des reçus du patient",
                            "data": [
                                {
                                "id": "REC-2026-001",
                                "numero_recu": "CAISSE-4587",
                                "date_recu": "2026-02-16",
                                "montant_total": 150000,
                                "net_a_payer": 150000,
                                "services": [
                                    {
                                    "id": "SVC-001",
                                    "nom_service": "Consultation générale",
                                    "code_service": "CONSULT-01",
                                    "actes": [
                                        {
                                        "id": "ACT-001",
                                        "nom_acte": "Consultation adulte",
                                        "code_acte": "ACT-CONS-01",
                                        "montant_acte": 150000,
                                        "quantite_acte": 1,
                                        "net_a_payer_patient": 150000,
                                        "montant_payer_patient": 150000
                                        }
                                    ]
                                    }
                                ]
                                }
                            ],
                            "meta": {
                                "current_page": 1,
                                "last_page": 3,
                                "per_page": 20,
                                "total": 45
                            }
                            }

Réponse Erreur (404)

{
                        "success": false,
                        "message": "Patient introuvable"
                        }

Afficher le Détail d’un Reçu d’un Patient

Cet endpoint permet de récupérer les informations détaillées d’un reçu spécifique appartenant à un patient.

GET /patients/{patientCode}/receipts/{receiptId}

                        https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/receipts/REC-2026-001
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Accept: application/json
                    

Paramètres d'URL

Paramètre Type Obligatoire Description
patientCode string Oui Numéro du patient
receiptId string Oui Identifiant du reçu à afficher (IDCAISSE)

Structure des données retournées

Champ Type Description
id string Identifiant du reçu
numero_recu string Numéro du reçu
date_recu date Date du reçu
montant_total numeric Montant total
net_a_payer numeric Montant net à payer
services array Liste des services associés
services[].actes array Liste des actes liés au service

Réponse Succès (200)

{
                            "success": true,
                            "message": "Détails du reçu",
                            "data": [
                                {
                                "id": "REC-2026-001",
                                "numero_recu": "CAISSE-4587",
                                "date_recu": "2026-02-16",
                                "montant_total": 150000,
                                "net_a_payer": 150000,
                                "services": [
                                    {
                                    "id": "SVC-001",
                                    "nom_service": "Consultation générale",
                                    "code_service": "CONSULT-01",
                                    "actes": [
                                        {
                                        "id": "ACT-001",
                                        "nom_acte": "Consultation adulte",
                                        "code_acte": "ACT-CONS-01",
                                        "montant_acte": 150000,
                                        "quantite_acte": 1,
                                        "net_a_payer_patient": 150000,
                                        "montant_payer_patient": 150000
                                        }
                                    ]
                                    }
                                ]
                                }
                            ]
                            }

Réponse Erreur (404 - Patient)

{
                        "success": false,
                        "message": "Patient introuvable"
                        }

Réponse Erreur (404 - Reçu)

{
                            "success": false,
                            "message": "Reçu introuvable"
                            }

Enregistrer ou modifier les résultats d’examen d’un patient

Permet d’enregistrer un examen médical pour un patient. Peut inclure un service, un acte, un reçu, un résultat, un fichier PDF encodé en base64 et éventuellement les données complètes d’une consultation.

POST /patients/{patientCode}/exam-results

                        POST https://api.usante.unitechnology.pro/v1/clients/patients/PAT-00125/exam-results
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Content-Type: application/json
                        Accept: application/json
                    

Paramètre d'URL

Paramètre Type Obligatoire Description
patientCode string Oui Le numéro du patient à afficher

Body JSON Complet


                    {
                        "serviceData": {
                            "id": 4,
                            "code_service": "SRV004",
                            "nom_service": "Service Chirurgie",
                            "nom_responsable": "Dr. Laurent Petit",
                            "telephone_responsable": "0178564321",
                            "service": "Chirurgie",
                            "urgence": true,
                            "pharmacie": false,
                            "chirugie": true,
                            "imagerie": false,
                            "biologie": false,
                            "gratuit_enfant": false,
                            "gratuit_femme_enceinte": true
                        },
                        "acteData": {
                            "id": 13,
                            "code_acte": "ACT4004",
                            "nom_acte": "Petite intervention chirurgicale",
                            "montant_acte": 15000,
                            "montant_payer_patient": 15000,
                            "net_a_payer_patient": 15000,
                            "quantite_acte": 1,
                            "certificat": true,
                            "gratuit_enfant": false,
                            "gratuit_femme_enceinte": true
                        },
                        "recuData": {
                            "id": "4",
                            "numero_recu": "RC10042026-0004",
                            "date_recu": "2026-02-14",
                            "montant_total": 15000,
                            "net_a_payer": 15000
                        },
                        "examResultData": {
                            "id": 103,
                            "date_saisie": "2026-02-14",
                            "patient_id": 53
                        },
                        "pdfData": "JVBERi0xLjQKJcfsj6IKMSAwIG9iago=.....",
                        "isConsultaion": true,
                        "consultationData": {
                            "id": 202,
                            "date_consultation": "2026-02-14",
                            "date_debut_maladie": "2026-02-10",
                            "traitement_pris": "Antibiotiques",
                            "diagnostic": "Infection post-opératoire",
                            "motif_consultation": "Suivi post-chirurgie",
                            "resultat_consultation": "Amélioration",
                            "date_rendez_vous": "2026-02-20",
                            "nature_traitement": "Médicaments",
                            "symptomes_associes": "Douleur légère",
                            "commentaire_traitement": "Repos",
                            "type_de_visite": "Consultation",
                            "visite": "Suivi",
                            "nom_des_medecins_effectuant_la_visite": "Dr. Laurent Petit",
                            "type_consultation": "Standard",
                            "temperature": 37,
                            "tension_gauche": 13,
                            "tension_droite": 13,
                            "pouls": 82,
                            "poids": 72,
                            "bmi": 24,
                            "taille_patient": 178,
                            "commentaire": "Patient stable"
                        },
                        "constanteData": {
                            "id": 303,
                            "date_enregistrement": "2026-02-14",
                            "temperature": 37,
                            "tension_gauche": 13,
                            "tension_droite": 13,
                            "pouls": 82,
                            "poids": 72,
                            "taille_patient": 178,
                            "etat_general_du_patient": "Bon",
                            "valeur_imc": 24,
                            "glucemie_capillaire": 5.0,
                            "bandelette_urinaire": 1.8,
                            "saturation_sop2": 97
                        },
                        "medicamentConsultationData": {
                            "id_medicament_par_ordonnance": 402,
                            "medicament": "Amoxicilline",
                            "forme": "Comprimé",
                            "duree": 7,
                            "posologie": 1,
                            "indice_periode_duree": 2,
                            "indice_periode_posologie": 1,
                            "mode_prise_de_medicament": "Orale"
                        },
                        "ordonnanceExamenData": {
                            "id": 502
                        },
                        "infoPDFData": "JVBERi0xLjQKJcfs..."
                    }
                    

Champs Racine Détails Complet

serviceData
Champ Type Obligatoire Description
id integer Oui Identifiant du service
code_service string Oui Code unique du service
nom_service string Oui Nom du service
nom_responsable string Non Nom du responsable
telephone_responsable string Non Téléphone du responsable
service string Non Type de service
urgence boolean Non Service urgence
pharmacie boolean Non Présence pharmacie
chirugie boolean Non Service chirurgie
imagerie boolean Non Service imagerie
biologie boolean Non Service biologie
gratuit_enfant boolean Non Service gratuit pour enfant
gratuit_femme_enceinte boolean Non Service gratuit pour femme enceinte
acteData
Champ Type Obligatoire Description
id integer Oui Identifiant de l’acte
code_acte string Oui Code unique de l’acte
nom_acte string Oui Nom de l’acte
montant_acte numeric Oui Montant total de l’acte
montant_payer_patient numeric Oui Montant payé par le patient
net_a_payer_patient numeric Oui Net à payer par le patient
quantite_acte integer Oui Quantité de l’acte
certificat boolean Non Indique si certificat fourni
gratuit_enfant boolean Non Acte gratuit pour enfant
gratuit_femme_enceinte boolean Non Acte gratuit pour femme enceinte
recuData
Champ Type Obligatoire Description
id integer Oui Identifiant du reçu
numero_recu string Oui Numéro unique du reçu
date_recu date Oui Date du reçu
montant_total numeric Oui Montant total du reçu
net_a_payer numeric Oui Montant net à payer
examResultData
Champ Type Obligatoire Description
id integer Non Identifiant du résultat examen
date_saisie date Non Date de saisie du résultat
patient_id integer Oui Identifiant du patient
pdfData
Champ Type Obligatoire Description
pdfData string (base64) Non Fichier PDF encodé
isConsultaion
Champ Type Obligatoire Description
isConsultaion boolean Oui Boolean pour savoir si il y a une consultation ou non
consultationData
Champ Type Obligatoire Description
id integer Non Identifiant de la consultation
date_consultation date Non Date de la consultation
date_debut_maladie date Non Date de début de la maladie
traitement_pris string Non Traitement pris par le patient
diagnostic string Non Diagnostic médical
motif_consultation string Non Motif de la consultation
resultat_consultation string Non Résultat de la consultation
date_rendez_vous date Non Date du prochain rendez-vous
nature_traitement string Non Nature du traitement
symptomes_associes string Non Symptômes associés
commentaire_traitement string Non Commentaires sur le traitement
type_de_visite string Non Type de visite
visite string Non Objet de la visite
nom_des_medecins_effectuant_la_visite string Non Nom du médecin
type_consultation string Non Type de consultation
temperature integer Non Température du patient
tension_gauche integer Non Tension artérielle gauche
tension_droite integer Non Tension artérielle droite
pouls integer Non Fréquence cardiaque
poids integer Non Poids du patient
bmi integer Non Indice de masse corporelle
taille_patient integer Non Taille du patient
commentaire string Non Commentaire général
constanteData
Champ Type Obligatoire Description
id integer Non Identifiant des constantes
date_enregistrement date Non Date d’enregistrement
temperature numeric Non Température du patient
tension_gauche integer Non Tension artérielle gauche
tension_droite integer Non Tension artérielle droite
pouls integer Non Fréquence cardiaque
poids numeric Non Poids du patient
taille_patient numeric Non Taille du patient
etat_general_du_patient string Non État général
valeur_imc numeric Non Indice de masse corporelle
glucemie_capillaire numeric Non Glycémie capillaire
bandelette_urinaire numeric Non Résultat bandelette urinaire
saturation_sop2 numeric Non Saturation en O2
medicamentConsultationData
Champ Type Obligatoire Description
id_medicament_par_ordonnance integer Non Identifiant du médicament par ordonnance
medicament string Non Nom du médicament
forme string Non Forme (comprimé, sirop…)
duree integer Non Durée du traitement
posologie integer Non Nombre de prises par période
indice_periode_duree integer Non Indice de période durée (jours, semaines…)
indice_periode_posologie integer Non Indice de période posologie
mode_prise_de_medicament string Non Mode de prise (orale, injection…)
ordonnanceExamenData
Champ Type Obligatoire Description
id integer Non Identifiant de l’ordonnance examen
infoPDFData
Champ Type Obligatoire Description
infoPDFData string (base64) Non Fichier PDF encodé des ordonnances

Réponse Succès (201)

{
                            "success": true,
                            "message": "Résultat d'examen enregistré avec succès",
                            "data": {
                                "service": {...},
                                "acte": {...},
                                "recu": {...},
                                "examen": {...},
                                "consultation": {...}
                            }
                            }

Réponse Erreur (404)

{
                        "success": false,
                        "message": "Patient introuvable"
                        }

Réponse Erreur (500)

{
                        "success": false,
                        "message": "Erreur lors de l'enregistrement",
                        "error": "Message technique"
                        }

Lister Tous les Résultats d’Examens

Cet endpoint permet de récupérer tous les résultats d’examens liés aux patients d’un client API. Chaque résultat peut inclure le fichier PDF de l’examen ainsi que le PDF associé à l’ordonnance d’examen.

GET /patients/exam-results

                        https://api.usante.unitechnology.pro/v1/clients/patients/exam-results
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Accept: application/json
                    

Paramètres URL

Aucun paramètre spécifique pour cette route.

Réponse Succès (200)

{
                        "success": true,
                        "message": "Liste des examens récupérée avec succès.",
                        "data": [
                            {
                            "examens": {
                                "id": "RES-001",
                                "date_saisie": "2026-02-16",
                                "pdf": "https://api.usante.unitechnology.pro/storage/results/RES-001.pdf"
                            },
                            "ordonnanceExamen": {
                                "id": "ORD-001",
                                "pdf": "https://api.usante.unitechnology.pro/storage/results/ORD-001.pdf"
                            }
                            },
                            {
                            "examens": {
                                "id": "RES-002",
                                "date_saisie": "2026-02-17",
                                "pdf": null
                            },
                            "ordonnanceExamen": null
                            }
                        ]
                        }

Réponse Erreur (401)

{
                        "success": false,
                        "message": "Client API introuvable.",
                        "data": []
                        }

Réponse Erreur (404)

{
                        "success": false,
                        "message": "Société associée au client API introuvable.",
                        "data": []
                        }

Réponse Erreur (500)

{
                        "success": false,
                        "message": "Une erreur est survenue : Message technique",
                        "data": []
                        }

Chaque élément de la liste contient :

  • examens : Détails du résultat d’examen (ID, date de saisie et PDF).
  • ordonnanceExamen : Détails du PDF de l’ordonnance associé au résultat d’examen (si disponible).

Lister les résultats d’examens d’un patient

Cet endpoint permet de récupérer tous les résultats d’examens d’un patient spécifique, identifiés par patientCode. Chaque résultat peut inclure le fichier PDF de l’examen ainsi que le PDF associé à l’ordonnance d’examen.

GET /patients/{patientCode}/exam-results

                        https://api.usante.unitechnology.pro/v1/clients/patients/12345/exam-results
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Accept: application/json
                    

Paramètres URL

  • patientCode (string) : Code unique du patient fourni par le client API.

Réponse Succès (200)

{
                        "success": true,
                        "message": "Liste des examens du patient récupérée avec succès.",
                        "data": [
                            {
                            "examens": {
                                "id": "RES-001",
                                "date_saisie": "2026-02-16",
                                "pdf": "https://api.usante.unitechnology.pro/storage/results/RES-001.pdf"
                            },
                            "ordonnanceExamen": {
                                "id": "ORD-001",
                                "pdf": "https://api.usante.unitechnology.pro/storage/results/ORD-001.pdf"
                            }
                            },
                            {
                            "examens": {
                                "id": "RES-002",
                                "date_saisie": "2026-02-17",
                                "pdf": null
                            },
                            "ordonnanceExamen": null
                            }
                        ]
                        }

Réponse Succès – aucun examen (200)

{
                        "success": true,
                        "message": "Aucun examen trouvé pour ce patient.",
                        "data": []
                        }

Réponse Erreur (401)

{
                        "success": false,
                        "message": "Client API introuvable.",
                        "data": []
                        }

Réponse Erreur (404)

{
                        "success": false,
                        "message": "Société associée au client API introuvable.",
                        "data": []
                        }
{
                        "success": false,
                        "message": "Patient introuvable.",
                        "data": []
                        }

Réponse Erreur (500)

{
                        "success": false,
                        "message": "Une erreur est survenue lors de la récupération des examens.",
                        "data": []
                        }

Chaque élément de la liste contient :

  • examens : Détails du résultat d’examen (ID, date de saisie et PDF si disponible).
  • ordonnanceExamen : Détails du PDF de l’ordonnance associé au résultat d’examen (si disponible).

Afficher un résultat d’examen d’un patient

Cet endpoint permet de récupérer un résultat d’examen spécifique d’un patient identifié par patientCode et resultId. Chaque résultat inclut le PDF de l’examen ainsi que le PDF associé à l’ordonnance si disponible.

GET /patients/{patientCode}/exam-results/{resultId}

                        https://api.usante.unitechnology.pro/v1/clients/patients/12345/exam-results/RES-001
                    

Headers


                        Authorization: Bearer VOTRE_API_KEY
                        Accept: application/json
                    

Paramètres URL

  • patientCode (string) : Code unique du patient fourni par le client API.
  • resultId (string) : Identifiant unique du résultat d’examen.

Réponse Succès (200)

{
                        "success": true,
                        "message": "Résultat d'examen récupéré avec succès.",
                        "data": {
                            "examens": {
                            "id": "RES-001",
                            "date_saisie": "2026-02-16",
                            "pdf": "https://api.usante.unitechnology.pro/storage/results/RES-001.pdf"
                            },
                            "ordonnanceExamen": {
                            "id": "ORD-001",
                            "pdf": "https://api.usante.unitechnology.pro/storage/results/ORD-001.pdf"
                            }
                        }
                        }

Réponse Erreur (401)

{
                        "success": false,
                        "message": "Client API introuvable.",
                        "data": null
                        }

Réponse Erreur (404)

{
                        "success": false,
                        "message": "Société associée au client API introuvable.",
                        "data": null
                        }
{
                        "success": false,
                        "message": "Patient introuvable.",
                        "data": null
                        }
{
                        "success": false,
                        "message": "Résultat d'examen introuvable pour ce patient.",
                        "data": null
                        }

Réponse Erreur (500)

{
                        "success": false,
                        "message": "Une erreur est survenue lors de la récupération du résultat.",
                        "data": null
                        }

L’objet data contient :

  • examens : Détails du résultat d’examen (ID, date de saisie et PDF si disponible).
  • ordonnanceExamen : PDF de l’ordonnance associé au résultat d’examen (si disponible).

Codes erreurs HTTP

200 Succès
201 Créé
400 Mauvaise requête
401 Non autorisé
500 Erreur serveur