AkibaBÊTA
↵
Proposer un jeu

API Akiba

Accédez au catalogue public et à ses métadonnées.

OpenAPI JSON Catalogue

Premier appel

Les routes de lecture du catalogue public sont accessibles sans connexion ni clé API. Les réponses utilisent JSON.

curl "https://akiba-snowy.vercel.app/api/v1/creations?kind=game&engine=Three.js"

Cet exemple fonctionne depuis un terminal ou votre serveur. Les appels depuis un autre site web dépendent de la politique CORS ; aucune intégration navigateur tierce n’est promise ici.

Routes publiques

GET/api/v1/creations

Liste des créations publiées, avec filtres.

GET/api/v1/creations/{id}

Fiche d’une création par identifiant ou slug.

GET/api/v1/creators

Profils publics des créateurs.

GET/api/v1/creators/{id}

Profil d’un créateur par identifiant ou slug.

GET/api/v1/registry

Technologies, modèles et outils référencés.

Filtrer les créations

Les paramètres de /creations se combinent : une création doit respecter tous les filtres demandés.

q, creator, genre, engine
Texte recherché, identifiant du créateur, genre et nom du moteur.
kind, stage, dimensions, input, health
Type, avancement, 2D/3D, commandes et dernier état de disponibilité.
technology, model, tool, ai
Identifiant ou nom d’une technologie, d’un modèle ou d’un outil ; usage d’IA déclaré.
code=available, oneShot=true
Présence d’un dépôt ou déclaration d’une création en une instruction. Ces données ne certifient ni licence libre ni processus de création.

Les valeurs acceptées et les schémas complets sont décrits dans le fichier OpenAPI ci-dessus.

Comptes et écritures

La bibliothèque, les notes et les espaces créateur/admin utilisent une session Akiba. Les droits du propriétaire et les permissions administrateur sont contrôlés côté serveur. Il n’existe pas encore de clés personnelles ni de procédure d’autorisation pour des applications tierces.

Erreurs

Les erreurs renvoient un statut HTTP et un objet error : 400 pour une requête invalide, 401/403 pour les accès protégés, 404 pour une ressource absente, 409 pour un conflit de révision et 429 pour une limite atteinte.

{
  "error": {
    "code": "HTTP_404",
    "message": "Creation not found"
  }
}

État de l’API

L’API est en bêta. Les listes publiques ne sont pas encore paginées. Mettez vos résultats en cache et évitez les appels répétés inutiles. L’accès aux métadonnées n’accorde pas de droit de republication des jeux ou des médias.