Documentation API Faso Santé

Dernière mise à jour le 11/05/2022 à 21:57

Faso Santé met à disposition une API REST qui permet d'interagir avec ses données.

La 1ère chose est de s'inscrire avec le rôle Développeur sur le site.

Ensuite, sur la page d' infos compte, vous pourrez (ré-)générer une clé d'accès à l'API.

L'URL d'accès à l'API est https://www.fasopharmacies.ytsamy.name/api.

Pour vos tests, une base de données allégée est disponible sur https://www.test.fasopharmacies.ytsamy.name/api. Utilisez la clé API za7fk69vhtETXohFMDP2 ce qui donne un en-tête -H "Authorization: Basic emE3Zms2OXZodEVUWG9oRk1EUDI6Cg=="

Note: Afin de ne pas surcharger notre infrastructure, une limitation est appliquée au nombre de requêtes par utilisateur (ceci est indiqué dans l'en-tête de la réponse du serveur). Vous pouvez nous contacter si vous avez besoin de capacités supplémentaires.

Les exemples sont donnés avec l'outil en ligne de commande cURL. À vous de les adapter à votre client/langage de programmation favori. Le format général de la commande est le suivant:

curl [options] -i URL...

Les principales options sont les suivantes:

-X, --request <command>
la méthode de la requête: POST, GET (par défaut), ...
-H, --header <header>
insère un en-tête HTTP; à réutiliser pour chaque en-tête que vous souhaitez définir. Faso Pharmacies utilise l'authentification basique HTTP. Ainsi, il faut ajouter à chaque requête le paramètre "-H 'Authorization: Basic xxxxxxx'" où xxxxxxx est la clé d'accès à l'API suivie d'un deux points (:), le tout encodé en base64.
-i, --include
affiche les en-têtes de la réponse HTTP
-d, --data <data>
le corps de la requête

Vous pouvez consulter le manuel (en anglais).

Afficher/Masquer tout

Lister les établissements de Santé

Lister les villes

Trouver une ville à partir de coordonnées

Lister les assureurs

Trouver les établissements de santé à proximité (coordonnées GPS)

Trouver les établissements de santé d'une ville

Lister les votes

Liste des types

Liste des catégories

Vote pour un établissement

Créer un nouvel établissement

Prix d'un médicament

Afficher/Masquer tout