Aller au contenu

Démarrer en 5 minutes

Faites votre premier appel à l'API 221 sans inscription, puis créez une clé gratuite pour un quota plus large.

Faites un premier appel, sans clé

Aucune inscription n'est nécessaire : copiez l'exemple dans votre langage, ou envoyez la requête avec « Essayer ». Sans clé, vous disposez de 100 appels par jour et par adresse IP.

La route GET /v1/jours-feries liste les jours fériés du Sénégal, avec leur statut et leurs sources. Ajoutez ?year=2026 pour filtrer par année.

GET
/v1/jours-feries

Paramètres de requête

page?integer
Formatint64
Plage1 <= value
Par défaut1
per_page?integer
Formatint64
Plage1 <= value <= 100
Par défaut20
q?string

Recherche plein texte, sans accents ni casse.

Longueur1 <= length
type?string
date_status?string
year?string
Motif^\d{4}$

Corps de la réponse

application/json

application/json

curl -X GET "https://example.com/v1/jours-feries"
{  "data": [    {      "date": "2019-08-24",      "date_status": "confirmee",      "id": "2026-nouvel-an",      "name": {        "en": "New Year's Day",        "fr": "Jour de l'an"      },      "sources": [        {          "lang": "fr",          "official": true,          "title": "string",          "url": "http://example.com",          "verifiedOn": "2019-08-24"        }      ],      "type": "civile"    }  ],  "pagination": {    "page": 0,    "per_page": 0,    "total": 0,    "total_pages": 0  }}

Lisez la réponse

La réponse est en JSON. Les en-têtes RateLimit-Remaining et RateLimit-Reset indiquent le nombre d'appels restants et le délai avant la remise à zéro, en secondes.

Créez une clé gratuite

Connectez-vous au tableau de bord 221 Pay, créez un projet puis une clé. Le tableau de bord est une application distincte de l'API : ce lien ouvre celui de l'environnement qui sert cette documentation, le même que l'URL de base de l'étape suivante. Le secret n'est affiché qu'une fois : copiez-le aussitôt. Le détail est dans Authentification et clé.

Appelez avec la clé

Ajoutez l'en-tête Authorization : le quota passe de 100 à 1 000 appels par jour. API_URL est l'URL de base, https://apps.orvlabs.com. Définissez les deux variables, puis lancez l'appel.

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

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

Et ensuite ?