Bienvenue sur l'Api culturo

Utilisation

Cette api de type REST utilise une authentication par jeton JWT (JSON Web Token). Afin d'utiliser cette Api, vous devez préalablement créer un compte vous permettant de générer un jeton lors de la phase d'autentification.

1. Obtention du jeton

Apres création de votre compte, vous pouvez obtenir un jeton en utilisant par exemple une commande curl:

curl -X POST  https://api.culturo.fr/api/login_check -d username=culturo_user -d password=test
Vous devez normalement recevoir une réponse de cette forme:
{
   "token" : "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXUyJ9.eyJleHAiOjE0MzQ3Mjc1MzYsInVzZXJuYW1lIjoia29ybGVvbiIsImlhdCI6IjE0MzQ2NDExMzYifQ.nh0L_wuJy6ZKIQWh6OrW5hdLkviTs1_bau2GqYdDCB0Yqy_RplkFghsuqMpsFls8zKEErdX5TYCOR7muX0aQvQxGQ4mpBkvMDhJ4-pE4ct2obeMTr_s4X8nC00rBYPofrOONUOR4utbzvbd4d2xT_tj4TdR_0tsr91Y7VskCRFnoXAnNT-qQb7ci7HIBTbutb9zVStOFejrb4aLbr7Fl4byeIEYgp2Gd7gY"
}
si tout s'est bien passé ou
{
  "code": 401,
  "message": "Bad credentials"
}
si vos identifiants ne sont pas valides.

Le jeton obtenu a une durée de vie de 24h. Après cela ,vous devrez vous authentifier de nouveau et obtenir un nouveau jeton.

2. Utilisation du jeton

Toutes les requêtes effectuées doivent comporter un header d'authentification de la forme:
Authorization: Bearer {token}
exemple :
curl -X GET -H "Authorization : Bearer eyJhbGciOiJSUzI1NiJ9.eyJyb2xlcyI6WyJST0xFX0FQSSIsIlJPTEVfVVNFUiJdLCJ1c2VybmFtZSI6InRvdG8iLCJpcCI6Ijg2LjIzNy44LjI0OCIsImRlcGFydGVtZW50SWQiOiIwNiIsImV4cCI6MTQ5NDY4MDkyOSwiaWF0IjoxNDk0NTk0NTI5fQ.Ls0GQQwumf3qM0d6n_ocTibR2Lij8D-yXWXZPSninvmReG_VdyHo6Yn3Ft7HOI-7Mf1MkGZwwEDE0BUyaCtAcWFj1WmM-syojeFY1Y3ivKBhogRRz9S7ElA5zWa-ulV4CEQT0xr9Tt44zTyvhHf-fSPJLzt74b0w9s0H3BF85S_jK52QI_7VguWcynqXuc9269MxkYIT6SBIH0waZ6vmOvkcwbs0GTJiFIjHK9GujNjxA0gY3LlqmruSCMJHklJdbM9Xqr7EIWleKCA9zAw6zG0sVGx2fWKUjZodngTJpSimVwTkXvs119__BUxpdnnfQq4FGC5QQTPEJKbEjP6CBPWG_ngo4dGYN1Ddv4SujnEe3hZnkmgCBEashg485wAFz2pWYloBpCnqEETmdNuhk1gapf3WCUzuNq-hJ0_5LBEUkhf4WKgxrRvFftV5NPCZ4W1BOBhyKZM50jkZyjhDbhsTOxyYFx9nld3kuHmEnKf6xFri_hAoQd-llTEHAGy5xGC7yRzJZdTVPsHF3Q5E5yPlJFpiOpbepgwTfSSMJ9ouxAXqqjXHUxjEZiMEGtXWKQjqW48KynwEzX4xKxGcOQz2EhL6SFXXxAmEEjAD1PXzc0t_Y68pgqW79lp-XMkNG_LYp4iGQ7bHPzGRF4C2FZdX6Df9eblrNkGVM96bXvU" api.culturo.fr/api/equipements
Si votre jeton n'est plus valide, le réponse sera :
{
  "code": 401,
  "message": "Expired JWT Token"
}

Les différentes requêtes sont présentées dans la documentation .
Attention, hormis pour récupérer un token qui nécessite une requête POST, seules les requêtes GET sont autorisées.

Medias

Culturo recense trois catégories de médias : images, documents (pdf) et médias externes hébergés sur des plateformes spécifiques (youtube, soundcloud...)

Pour les deux premières catégories, vous pouvez récupérer les medias à l'adresse suivante : http://media.culturo.fr.
Chaque media est stocké dans un répertoire correspondant à sa catégorie et éventuellement dans un sous répertoire.


        "images": [
      {
        "id": 541047,
        "name": "",
        "copyright": "Copyright",
        "dir": "",
        "type": "image/PNG",
        "file": "13621380980_046_adpa.png",
        "category": "Image"
      }
    ],

Dans l'exemple ci-dessus, le sous-repertoire est vide ("dir":""). Le media est donc accessible à l'adresse suivante : http://media.culturo.fr/images/13621380980_046_adpa.png.

N'oubliez pas de mentionner le copyright de l'auteur si celui-ci est renseigné.

Licence

licence ouverte"

Contact

Pour toute question, merci de nous écrire à culturo->culturo.fr