whatweek.ca
Voyez en direct quelle semaine de l’année nous sommes au Canada, avec le numéro de semaine actuel et les dates de début et de fin de la semaine.
Clés API & limites de débit
Notre API publique est gratuite et sans clé pour un usage modéré. Pour des volumes plus élevés, demandez une clé partenaire — c'est gratuit pour les usages non commerciaux.
Limites par défaut
| Type d'accès | Limite par minute | Mode |
|---|---|---|
| Anonyme (par IP) | 60 | Aucune clé requise |
| Clé partenaire | 600+ | X-API-Key ou ?api_key= |
Les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset sont retournés sur chaque réponse. En cas de dépassement, l'API retourne 429 avec un en-tête Retry-After.
Comment authentifier
Une fois votre clé reçue, envoyez-la dans l'en-tête X-API-Key, dans Authorization: Bearer <clé>, ou en paramètre de requête api_key=.
# Header (recommended)
curl -H "X-API-Key: $WHATWEEK_KEY" \
"https://whatweek.ca/api/holidays.json?province=on&year=2026"
# Query parameter
curl "https://whatweek.ca/api/week.json?api_key=$WHATWEEK_KEY"Demander une clé
Envoyez-nous un courriel avec votre nom, votre projet et le volume estimé. Nous répondons généralement sous 48 heures.
Bonnes pratiques
- Mettez en cache les réponses côté client (les fériés changent rarement).
- Respectez l'en-tête Retry-After lorsque vous recevez 429.
- Ne partagez pas votre clé publiquement (pas de front-end exposé).
- Identifiez-vous via un User-Agent descriptif.