APIPour commencer

Authentification

Aucune clé, aucun compte : l’API de WoWDB est publique. Identifiez simplement votre application.

Aucune clé#

L’API est publique et en lecture seule : aucune clé, aucun jeton, aucun compte. Les données sont celles du site, visibles par tous ; il n’y a rien à protéger, donc rien à authentifier.

Pas d’en-tête Authorization à envoyer : s’il y en a un, il est ignoré.

Aucune cléTerminal

curl https://api.wowdb.assemblee-defias.fr/v1/stats

Identifiez votre application#

Envoyez un en-tête User-Agent qui nomme votre application et donne un moyen de vous joindre (site, adresse, pseudo sur le forum). En cas de souci (boucle folle, trop de requêtes), nous pourrons vous prévenir au lieu de bloquer votre adresse.

Certains pare-feu refusent aussi les requêtes sans User-Agent : tous les exemples de cette documentation en posent un.

User-AgentTerminal

curl https://api.wowdb.assemblee-defias.fr/v1/stats \
  -H "User-Agent: bot-de-ma-guilde/2.1 (https://ma-guilde.example)"

HTTPS#

Utilisez toujours https://. Les adresses de l’API, des icônes et des cartes données dans les réponses sont absolues et en HTTPS.

Quotas#

Sans clé, les quotas s’appliquent par adresse IP : 120 requêtes par minute et 3000 par heure (limites de débit). Un besoin plus large (import complet, outil très fréquenté) ? Mettez les réponses en cache, ou écrivez-nous sur le forum.