Premier appel

Objectif : lister les jours fériés du Sénégal pour une année avec GET /v1/jours-feries, en envoyant votre clé, puis lire la réponse, le quota restant et les erreurs. Chaque jour férié porte son statut (confirmee ou previsionnelle) et ses sources.

Préparer l'environnementCopier le lien de la section

Définissez deux variables côté serveur : API_URL, l'URL de base (https://apps.orvlabs.com), et API_KEY, votre clé créée dans le tableau de bord 221 Pay (voir Authentification et clé).

API_URL=<URL de base ci-dessus>
API_KEY=sk_221_pay_test_…

Les exemples utilisent la bibliothèque standard, sauf Python (pip install requests) et Dart (dart pub add http).

Envoyer la requêteCopier le lien de la section

curl -i "$API_URL/v1/jours-feries?year=2026" \
  -H "Authorization: Bearer $API_KEY"

Lire la réponseCopier le lien de la section

{
  "data": [
    {
      "id": "2026-nouvel-an",
      "name": { "fr": "Jour de l'an", "en": "New Year's Day" },
      "date": "2026-01-01",
      "date_status": "confirmee",
      "type": "civile",
      "sources": [{ "title": "Loi n° 74-52 du 4 novembre 1974…", "official": true }]
    }
  ],
  "pagination": { "page": 1, "per_page": 20, "total": 14, "total_pages": 1 }
}

Les fêtes religieuses dépendent de l'observation de la lune : leur date_status est previsionnelle tant que la date n'est pas confirmée. Gardez date_status et les sources avec la date.

Gérer les erreurs et le quotaCopier le lien de la section

• RateLimit-Remaining donne le nombre d'appels restants aujourd'hui.
• Testez le champ code, pas le statut HTTP.
• INVALID_REQUEST : le champ fields indique quoi corriger.
• INVALID_API_KEY : clé inconnue ou mal formée ; API_KEY_EXPIRED et API_KEY_REVOKED : clé expirée ou révoquée.
• QUOTA_EXCEEDED (429) : attendez Retry-After secondes ; ne relancez pas en boucle, le quota est quotidien.

Et ensuite ?Copier le lien de la section