APIOutils
Bibliothèques clientes : API de WoWDB
Les clients officiels de WoWDB, d’un seul fichier et sans dépendance, et la génération de clients par OpenAPI.
Bibliothèques officielles#
Chaque client tient en un seul fichier sans dépendance : copiez-le dans votre projet. Tous suivent la même interface : une méthode par ressource, la pagination automatique (iterate), une erreur typée avec le code de l’API, et une nouvelle tentative après Retry-After sur un 429.
sha256sum -c SHA256SUMS).Licence MIT (texte complet) : utilisez-les dans tout projet, y compris commercial, et modifiez-les librement, en gardant la mention de copyright et la licence, déjà incluses en fin de chaque fichier. Voir aussi les licences de la documentation et des données.
import { WowDb } from "./wowdb.mjs";
const wowdb = new WowDb({ userAgent: "bot-de-ma-guilde/1.0" });
const lame = await wowdb.items.retrieve("classic", 5191);
console.log(lame.name, lame.weapon.dps);
for await (const dague of wowdb.items.iterate("classic", { type: "dagger", rogue: true })) {
console.log(dague.name);
}Téléchargements#
JavaScript / TypeScriptNavigateur, Node.js 18+, Deno, Bun (ESM)v1.0.0testéwowdb.mjs· 7,7 Kio · types : wowdb.d.tsSHA-256
295aef98caa298117604291a3ffb4fd2b31b8d05b28a79b495300e05218d21e7
PythonPython 3.8+, bibliothèque standardv1.0.0testéwowdb.py· 7,7 KioSHA-256
de4da2b8dc7d7f8d8c865686ed1f0d49c4dbc7f3a626fdc1523ff603c4151379
PHPPHP 8.1+, extension jsonv1.0.0WowDb.php· 6,5 KioSHA-256
a80919370ebc59ae6d41a69415cdff9c4f3978c85595a66d8044df6d6a5cf9a1
RubyRuby 3.0+, bibliothèque standardv1.0.0wowdb.rb· 5,3 KioSHA-256
2a0b972dea33332406e930ea97bed7eab0559bfdb40bed971fea317d9a86b6bb
GoGo 1.18+, bibliothèque standardv1.0.0wowdb.go· 6,6 KioSHA-256
bc0eefd78abd54bbcb9d3b663888df007fb972f2e7d337a0bbbe0fa9e308c51c
JavaJava 11+, java.net.http, lecteur JSON intégrév1.0.0WowDb.java· 13,2 KioSHA-256
7229fa83f2e245465fe7f0082610f58435966f639f6c5ae8549f639babd77e47
C# / .NET.NET 8+, System.Text.Jsonv1.0.0WowDb.cs· 8,1 KioSHA-256
f70d0cc7af58ecac6bd48507b43e595052eb15af5aa38a6c53621efa8e8a3518
Les clients marqués « testé » sont exécutés contre l’API à chaque série de tests de WoWDB ; les autres suivent la même interface et les mêmes règles (erreurs, pagination, Retry-After). Un souci, une amélioration ? Dites-le sur le forum.
Générer un client depuis OpenAPI#
Pour un client typé dans un autre langage, ou avec vos conventions, générez-le depuis la spécification OpenAPI 3.1. Quelques générateurs connus :
| Langage | Outil | Commande |
|---|---|---|
| TypeScript (types) | openapi-typescript | npx openapi-typescript https://api.wowdb.assemblee-defias.fr/v1/openapi.json -o wowdb.d.ts |
| TypeScript (client fetch) | OpenAPI Generator | openapi-generator-cli generate -i https://api.wowdb.assemblee-defias.fr/v1/openapi.json -g typescript-fetch -o wowdb-ts |
| Python | openapi-python-client | openapi-python-client generate --url https://api.wowdb.assemblee-defias.fr/v1/openapi.json |
| Go | oapi-codegen | oapi-codegen -package wowdb -generate types,client openapi.json > wowdb.gen.go |
| Java | OpenAPI Generator | openapi-generator-cli generate -i https://api.wowdb.assemblee-defias.fr/v1/openapi.json -g java -o wowdb-java |
| C# | NSwag | nswag openapi2csclient /input:https://api.wowdb.assemblee-defias.fr/v1/openapi.json /namespace:WowDb /output:WowDb.cs |
| PHP | OpenAPI Generator | openapi-generator-cli generate -i https://api.wowdb.assemblee-defias.fr/v1/openapi.json -g php -o wowdb-php |
| Ruby | OpenAPI Generator | openapi-generator-cli generate -i https://api.wowdb.assemblee-defias.fr/v1/openapi.json -g ruby -o wowdb-ruby |
| Rust | OpenAPI Generator | openapi-generator-cli generate -i https://api.wowdb.assemblee-defias.fr/v1/openapi.json -g rust -o wowdb-rust |
| Kotlin, Swift, Dart… | OpenAPI Generator | openapi-generator-cli list donne les 50 générateurs de clients |
curl -o openapi.json https://api.wowdb.assemblee-defias.fr/v1/openapi.json.API de WoWDB des Défias, v1. Données du jeu © Blizzard Entertainment. Conditions d’usage · Markdown · llms.txt · OpenAPI