API Documentation

A l'heure actuelle l'API peut :
- Retourner l'URL du flux video (360p et HD) d'une vidéo
- Retourner la description d'une vidéo
- Retourner l'uploader/auteur d'une vidéo
- Retourner le nom d'une vidéo
- Retourner l'URL de l'image de miniature d'une vidéo
- Retourner la date de mise en ligne d'une vidéo
- Retourner tout les VideoID des vidéos en ligne
- Retourner la version de l'API

Tout les actions de l'API, sauf celle pour retourner la liste de vidéos, requierent le VideoID en argument
Notez que l'API retourne les valeurs en plain-text, et non en JSON ou autre, il n'y à pas de raison particulière, principalement de la flemardise

Structure

Structure de la requête

La structure de l'API est assez simple, il y à deux arguments :
- want
- v_id

v_id Correspond au VideoID de la video sur laquelle on veut utiliser l'API
want Correspond a l'action que l'on demande a l'API
(à noter que l'ordre des arguments est interchangeable)

Et avec le lien : http://turion64.fr.nf/video/api.php?v_id={VIDEO_ID_HERE}&want={API_ACTION_HERE}

Et voilà justement les actions de l'API:

API_ACTION	Fonction
video_url	Retourne l'url du flux video SD (360p)
hd_video_url	Retourne l'url du flux video HD
description	Retourne la description de la video
uploader	Retourne l'uploader de la video
name	Retourne le nom de la vidéo
thumbnail_url	Retourne l'url de l'image de miniature de la vidéo
date	Retourne la date d'upload de la video
video_list	Retourne les VideoID de toutes les videos en ligne
api_ver	Retourne la version de l'api

A noter que toutes les fonctions sauf les deux dernières doivent avoir un VideoID valide dans l'argument v_id

Structure de la réponse

Si la requête est comprise, l'API commence la réponse avec un "ok:" + l'élément demandé
Si il y à un problème, l'api commence la réponse avec "error:" + l'erreur

Les erreurs

Parceque vous allez forcément en rencontrer une...
Rappel : toutes les erreurs commences avec "error:", donc par exemple pour l'erreur "empty-request", l'API répondra "error:empty-request",etc...

Erreur de l'API	Signification
empty-request	l'argument want est vide ou non-présent
not-recognized-req	l'API_ACTION dans l'argument want n'est pas reconnu
empty-vid	l'argument v_id est vide ou non-présent
non-existant-vid	la video demandée dans le v_id n'existe pas

Fonctionnement de chaque action

Pour tout les exemples nous utiliserons le VideoID "1400509539"

- video_url :

Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?v_id=1400509539&want=video_url"
retourne :ok:http://turion64.fr.nf/video/flash_medias/1400509539.mp4

- hd_video_url :

Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?v_id=1400509539&want=hd_video_url"
retourne :ok:http://turion64.fr.nf/video/medias/1400509539.mp4

- description :

Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?v_id=1400509539&want=description"
retourne :ok:Voilà la v1.1 de TurionVids ! Avec enfin une liste de vidéos qui est correcte, des miniatures, le support de thèmes et une pseudo-base de données, plutôt que de générer la page de lecture à l'upload, cela me facilitera énormément chaque mise à jour :) Il peut y avoir des bugs (surtout dans l'uploader, j'ai pas trop le temps de tout tester), donc si vous en voyez, signalez-le moi. Voilà c'est pas idéal, mais c'est bien mieux qu'avant.

- uploader :

Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?v_id=1400509539&want=uploader"
retourne :ok:Turion_64

- name :

Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?v_id=1400509539&want=name"
retourne :ok:[Hatsune Miku] PoPiPo

- thumbnail_url :

Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?v_id=1400509539&want=thumbnail_url"
retourne :ok:http://turion64.fr.nf/video/thumbnails/1400509539_thumb.jpg

- date :

La séparation entre la date et l'heure est faite par un "-" (tiret du 6)
Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?v_id=1400509539&want=date"
retourne :ok:01/12/2018-00:34:17

- video_list :

Cette action ne requiert pas de VideoID
Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?want=video_list"
retourne :ok:6726900551 2147944738 2279808402 1863353212 6118868687 2003035174 2556217112 1413895423 1400509539 2924063609 3707060724

- api_ver :

Cette action ne requiert pas de VideoID
Exemple d'utilisation :
L'URL "http://turion64.fr.nf/video/api.php?want=api_ver"
retourne :ok:crapi v0.1b