Documentation API

Bienvenue dans la documentation de l'API Pharmacie de Garde Maroua. Cette API RESTful vous permet d'accéder aux données des pharmacies de garde, aux horaires et aux évaluations.

URL de base


                                    https://pharmacies.mit.cm/api

Format de réponse

Toutes les réponses sont au format JSON avec l'en-tête Content-Type: application/json

Authentification

Certains endpoints nécessitent une authentification. Utilisez un token Bearer dans l'en-tête Authorization.

Authorization: Bearer YOUR_ACCESS_TOKEN

Les endpoints publics (liste des pharmacies, horaires) ne nécessitent pas d'authentification.

Pharmacies

GET /api/pharmacies

Récupère la liste de toutes les pharmacies disponibles.

Réponse

{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Pharmacie Centrale",
      "address": "Avenue Hassan II",
      "phone": "+237 699 99 99 99",
      "latitude": 10.5897,
      "longitude": 14.3154,
      "district": "Domayo",
      "is_active": true,
      "is_24_hours": false,
      "average_rating": 4.5,
      "ratings_count": 12
    }
  ]
}

GET /api/pharmacies/on-duty

Récupère uniquement les pharmacies de garde actuellement ouvertes.

GET /api/pharmacies/nearby

Trouve les pharmacies à proximité d'une position GPS donnée.

Paramètres (Query)

latitude Latitude (requis) - Type: float

longitude Longitude (requis) - Type: float

radius Rayon en km (optionnel, défaut: 10) - Type: integer

Exemple de requête

GET /api/pharmacies/nearby?latitude=10.5897&longitude=14.3154&radius=5

GET /api/pharmacies/{id}

Récupère les détails complets d'une pharmacie spécifique par son ID.

Horaires de Garde

GET /api/schedules/day/{date}

Récupère les pharmacies de garde pour un jour spécifique.

Exemple

GET /api/schedules/day/2025-12-01

GET /api/schedules/week/{date}

Récupère les pharmacies de garde pour toute la semaine contenant la date spécifiée.

GET /api/schedules/month/{year}/{month}

Récupère toutes les pharmacies de garde pour un mois spécifique.

Exemple

GET /api/schedules/month/2025/12

Évaluations

GET /api/pharmacies/{id}/ratings

Récupère toutes les évaluations d'une pharmacie spécifique.

POST /api/pharmacies/{id}/ratings Auth

Ajoute une nouvelle évaluation pour une pharmacie. Nécessite une authentification.

Corps de la requête (JSON)

{
  "rating": 5,
  "comment": "Excellent service et accueil chaleureux!"
}

Validation

rating - Requis, entier entre 1 et 5
comment - Optionnel, chaîne de caractères

Authentification (Endpoints)

POST /api/auth/login

Connexion via Google OAuth pour obtenir un token d'accès.

POST /api/auth/logout Auth

Déconnexion et révocation du token d'accès.

Codes d'erreur

Code	Signification
`200`	OK - Requête réussie
`400`	Bad Request - Paramètres invalides
`401`	Unauthorized - Authentification requise
`404`	Not Found - Ressource introuvable
`500`	Internal Server Error - Erreur serveur