Consulter la documentation API de Datagames

« Accueil datagames - Demander une clé Api

A propos de notre api

Pour qui, pourquoi ?

De nombreux sites de jeux vidéo maintiennent seuls une base de données. C'est une belle idée, mais longue à mettre en place de façon isolé et qui demande un investissement important.

Datagames propose un principe différent : nous construisons ensemble, grâce au principe du Gamekidama et aux développeurs, la grande base de données des jeux vidéo, complète et facile à utiliser. Développeurs, webmasters, amateurs, passionnés, cette api est à votre disposition. Remerciez nous en créant les applications de demain ! Demandez votre clé api

Protocoles, format

Nous vous fournissons une interface éprouvée pour disposer de toutes les données disponibles sur Datagames. Grâce aux méthode REST, vos appels sont rapides à éxecuter et vous en choisissez le format de sortie pour l'adapter à votre programmation (xml, json, html).

Sécurisation des appels

Clé api

Afin de sécuriser les appels, nous demandons à chaque utilisateur d'enregistrer une clé d'api. Cette clé nous permet de savoir qui fait quoi et de garantir la sécurité des données. Nos infrastructures étant hébergées en solution cloud, la disponibilité est garantie à 100%.

Cross-domain

Les clés d'api utilisées via une interface web devront renseigner leur adresse url, l'utilisation de l'api est autorisée pour tous les sites hébergés sous une même ip.

Les requêtes

Jeux

Liste des jeux

Complète

Renvoit une liste complète des jeux de Datagames (non-recommandée car plus long à exécuter qu'une demande filtrée)

GET » http://api.datagames.fr/games/{format}/{apiKey}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)

Filtrée

Renvoit une liste filtrée des jeux de Datagames (recommandée)

Les paramètres non utilisés doivent être mis à NULL

GET » http://api.datagames.fr/gamesFilter/{format}/{apiKey}/{name}/{ean13}/{editorCode}/ {developerCode}/{environmentCode}/{playersMin}/{playersMax}/{releaseMin}/{releaseMax}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{name} Nom du jeu
Pet être icmcomplet (pour une recherche par exemple)
{ean13} Code barre des jeux
Peut être imcomplet (pour une recherche par exemple)
{editorCode} Code de l'éditeur
Se référer à la liste des codes éditeurs
{developerCode} Code du développeur
Se référer à la liste des codes développeurs
{environmentCode} Code de l'environnement
Se référer à la liste des code environnements
{playersMin} Chiffre du nombre de joueur minimum
Valeur numérique obligatoire
{playersMax} Chiffre du nombre de joueur maximum
Valeur numérique obligatoire
{releaseMin} Date de sortie minimum (eu, us, jp confondus)
Formaté en YYYY-MM-JJ (1982-06-08) ou YYYY-MM-JJ-REGION (1982-06-08-EU)
{releaseMax} Date de sortie maximum (eu, us, jp confondus)
Formaté en YYYY-MM-JJ (1982-06-08) ou YYYY-MM-JJ-REGION (1982-06-08-EU)

Proposition d'un jeu

Permet de soumettre un jeu, laisser vide les paramètres non-renseignés

POST » http://api.datagames.fr/games/{apiKey}

A passer en Paramètre : [name] [description] [ean13] [editoSCode] [developerCode] [environmentCode] [genderCode] [playersMax] [releaseEu] [releaseUs] [releaseJp] [testUrl] [image] [video] [contributorEmail] [contributorName]

{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
[name]* Nom du jeu
Le nom est obligatoire
[ean13] Code barre du jeu
Doit être complet
[editorCode] Code de l'éditeur
Se référer à la liste des codes éditeurs
[developerCode] Code du développeur
Se référer à la liste des codes développeurs
[environmentCode]* Code de l'environnement
Se référer à la liste des codes environnements
[genderCode]* Code genre de jeu
Se référer à la liste des codes genre formaté en code1,code2,code3
[playersMax]* Chiffre du nombre de joueur maximum
Valeur numérique obligatoire
[releaseEu]* Date de sortie en Europe
Formaté en YYYY-MM-JJ
[releaseUs] Date de sortie aux Etats-unis
Formaté en YYYY-MM-JJ
[releaseJp] Date de sortie au Japon
Formaté en YYYY-MM-JJ
[testUrl] Liens vers des test
Formaté en url1,url2,url3
[image] Liens vers des images (si celles-ci vous appartiennent)
Formaté en img1,img2,img3
[video] Liens vers des vidéos (si celles-ci vous appartiennent)
Formaté en video1,video2,video3
[contributorEmail]* Adresse mail du contributeur
N'apparaitra pas dans les appels
[contributorName]* Nom/prénom ou pseudo du contributeur
N'apparaitra pas dans les appels

Visualisation d'un jeu

Renvoit les informations d'un jeu de Datagames

GET » http://api.datagames.fr/game/{format}/{apiKey}/{gameCode}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{gameCode}* Code du jeu
Le code du jeu est obligatoire

Environnements

Les environnement sont les plateformes de jeux disponibles sur le marché (les marques de console).

Liste des Environnements

Complète

Renvoit une liste complète des environnements de Datagames (non-recommandée car plus long à exécuter qu'une demande filtrée)

GET » http://api.datagames.fr/environments/{format}/{apiKey}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)

Filtrée

Renvoit une liste filtrée des environnements de Datagames (recommandée)

GET » http://api.datagames.fr/environmentsFilter/{format}/{apiKey}/{name}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{name} Nom de l'environnement
Peut être imcomplet (pour une recherche par exemple)

Visualisation d'un environnement

Renvoit les informations d'un environnement de Datagames

GET » http://api.datagames.fr/environment/{format}/{apiKey}/{environmentCode}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{environmentCode}* Code de l'environnement
Le code de l'environnement est obligatoire

Constructeurs

Les constructeurs sont les fabriquants de console de jeux.

Liste des constructeurs

Complète

Renvoit une liste complète des constructeurs de Datagames (non-recommandée car plus long à exécuter qu'une demande filtrée)

GET » http://api.datagames.fr/constructors/{format}/{apiKey}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)

Filtrée

Renvoit une liste filtrée des constructeurs de Datagames (recommandée)

GET » http://api.datagames.fr/constructorsFilter/{format}/{apiKey}/{name}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{name} Nom du constructeur
Peut être imcomplet (pour une recherche par exemple)

Visualisation d'un constructeur

Renvoit les informations d'un constructeur de Datagames

GET » http://api.datagames.fr/constructor/{format}/{apiKey}/{ConstructorCode}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{constructorCode}* Code du constructeur
Le code du constructeur est obligatoire

Liste des environnements liés à un constructeur

Renvoit les environements liés à un constructeur

GET » http://api.datagames.fr/constructor/environments/{format}/{apiKey}/{ConstructorCode}

Editeurs

Les éditeurs financent les jeux vidéo et s'occupent de leur commercialisation.

Complète

Renvoit une liste complète des éditeurs de Datagames (non-recommandée car plus long à exécuter qu'une demande filtrée)

GET » http://api.datagames.fr/editors/{format}/{apiKey}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)

Filtrée

Renvoit une liste filtrée des éditeurs de Datagames (recommandée)

GET » http://api.datagames.fr/editorsFilter/{format}/{apiKey}/{name}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{name} Nom de l'éditeur
Peut être imcomplet (pour une recherche par exemple)

Visualisation d'un éditeur

Renvoit les informations d'un éditeur de Datagames

GET » http://api.datagames.fr/editor/{format}/{apiKey}/{editorCode}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{editorCode}* Code de l'éditeur
Le code de l'éditeurs est obligatoire

Développeurs

Les développeurs créent les jeux vidéo, leurs univers, les héros, la musique.

Complète

Renvoit une liste complète des développeurs de Datagames (non-recommandée car plus long à exécuter qu'une demande filtrée)

GET » http://api.datagames.fr/developers/{format}/{apiKey}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)

Filtrée

Renvoit une liste filtrée des développeurs de Datagames (recommandée)

GET » http://api.datagames.fr/developersFilter/{format}/{apiKey}/{name}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{name} Nom du développeur
Peut être imcomplet (pour une recherche par exemple)

Visualisation d'un développeur

Renvoit les informations d'un développeur de Datagames

GET » http://api.datagames.fr/editor/{format}/{apiKey}/{developerCode}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{developerCode}* Code du développeur
Le code du développeur est obligatoire

Genres

Les genres définissent une catégorie de jeux et permettent une classification simple.

Complète

Renvoit une liste complète des genres de Datagames (non-recommandée car plus long à exécuter qu'une demande filtrée)

GET » http://api.datagames.fr/genders/{format}/{apiKey}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)

Filtrée

Renvoit une liste filtrée des genres de Datagames (recommandée)

GET » http://api.datagames.fr/gendersFilter/{format}/{apiKey}/{name}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{name} Nom du genre
Peut être imcomplet (pour une recherche par exemple)

Visualisation d'un genre

Renvoit les informations d'un genre de Datagames

GET » http://api.datagames.fr/gender/{format}/{apiKey}/{genderCode}

{format}* Format de sortie
valeur possible : xml, json, html
{apiKey}* Clé d'autorisation Api
La clé est obligatoire (Pour en obtenir une, cliquez-ici)
{genderCode}* Code du genre
Le code du genre est obligatoire