Kadaaran / api-kaamelott

API de citations de la série française Kaamelott

API citations Kaamelott

API de citations de la série française Kaamelott.

Introduction

L'API de citations Kaamelott est une API entièrement publique et ouverte à tous. L’API Kaamelott est une API JSON RESTful avec laquelle vous pouvez interagir à partir de n’importe quel langage avec une bibliothèque HTTP.

Base URL

L'URL de base pour toute l'API est https://kaamelott.chaudie.re/api. Si jamais lors d'une requête vous obtenez cette réponse:

{
  "status": 0,
  "error": "Chemin inconnu"
}

Vérifiez d'abord l'URL de base puis votre path. La documentation en dessous se base sur cette URL pour chaque requête.

Réponses

Succès

Un status 1 sera retourné, ainsi que le body contenant la réponse.

{
  "status":1,
  "citation":{
    "citation":" J'ai toujours dit que je supportais pas les jupes ;   mais c'est l'uniforme r\u00e9glementaire, j'y suis pour rien !",
    "infos":{
      "auteur":"Alexandre Astier",
      "acteur":"Bruno Salomone",
      "personnage":"Caius Camillus",
      "saison":"Livre I ",
      "episode":" 56 : Le Dernier Empereur"
    }
  }
}

Erreur

Un status 0 sera retourné, ainsi qu'un message d'erreur correspondant.

{
  "status": 0,
  "error": "Chemin inconnu"
}

Utilisation

Citations

GET /random
Retourne une citation aléatoire parmis toutes les citations disponibles.

GET /all
Retourne toutes les citations disponible. 776 citations sont disponibles.

Personnage

GET /random/personnage/:personnage
Retourne une citation aléatoire parmis toutes les citations du personnage.

GET /all/personnage/:personnage
Retourne toutes les citations du personnage.

Paramètres

Nom	Type	Description
personnage	String	Nom du personnage dont vous souhaitez les citations. Voir liste des personnages disponibles

Livre

GET /random/livre/:livre
Retourne une citation aléatoire parmis toutes les citations du livre.

GET /random/livre/:livre/personnage/:personnage
Retourne une citation aléatoire parmis toutes les citations du personnage dans le livre.

GET /all/livre/:livre
Retourne toutes les citations du livre.

GET /all/livre/:livre/personnage/:personnage
Retourne toutes les citations du personnage dans le livre.

Paramètres

Nom	Type	Description
livre	Integer	Chiffre entre 1 et 6. Numéro du livre dont vous souhaitez les citations.
personnage	String	Nom du personnage dont vous souhaitez les citations. Voir liste des personnages disponibles

Soundbox

GET /sounds/:filename
Retourne le fichier .mp3.

Paramètres

Nom	Type	Description
filename	String	Noms des fichiers dans sounds

Liste des personnages

  - Angharad
  - Anna
  - Appius Manilius
  - Arthur
  - Attila
  - Belt
  - Père Blaise
  - Bohort
  - Breccan
  - Le Roi Burgonde
  - Caius Camillus
  - Calogrenant
  - Capito
  - César
  - Cryda de Tintagel
  - Dagonet
  - La Dame du Lac
  - Demetra
  - Drusilla
  - Le Duc d'Aquitaine
  - Edern
  - Elias de Kelliwic'h
  - Galessin
  - Gauvain
  - Goustan
  - Grüdü
  - Guenièvre
  - Guethenoc
  - Hervé de Rinel
  - L'interprète burgonde
  - Le Seigneur Jacca
  - Les Jumelles du pêcheur
  - Le Jurisconsulte
  - Kadoc
  - Karadoc
  - Lancelot
  - Léodagan
  - Loth
  - Le Maître d'Armes
  - Méléagant
  - Manius Macrinus Firmus
  - Merlin
  - Mevanwi
  - Perceval
  - Roparzh
  - Lucius Sillius Sallustius
  - Séfriane d'Aquitaine
  - Séli
  - Spurius Cordius Frontinius
  - Le Tavernier
  - Urgan
  - Vérinus
  - Venec
  - Ygerne
  - Yvain