[API] Documentation

[leosw]

Pour ceux que ça intéresse, il y a une doc en cours de rédaction pour l'API, c'est ici :

http://leo.refuges.info/api/doc

[leosw]

Salut,

Bon, mauvaise idée, c'est vraiment lourd pour pas grand chose

Je vais me baser sur cette doc : https://newsblur.com/api

Léo

[sly]

Je me doute que c'est moins sexy :
http://www.refuges.info/wiki/api-refuges.info

Mais ça existe, et au moins, ça nous fera la documentation qui aura vocation à rester par la suite ?

[leosw]

Je suis têtu.

Je m'obstine à vouloir séparer API du reste, au cas où la base de donnée ou l'interface venait à changer. La doc de l'API n'a pas besoin de se retrouver dans le wiki, car elle n'est pas destinée au grand public. Mais le wiki peut contenir un lien vers l'API, une explication brève.

[sly]

Là, je ne parlais pour l'instant que de documentation. Donc un endroit où l'on puisse assez facilement l'écrire à plusieurs.

Tu as donné un lien vers l'API de chépasqui et je n'ai pas compris dans quel but. Si c'était pour donner une idée de syntaxe, ou si s'était pour écrire la doc.

[leosw]

C'était pour la doc (la mise en page), mais aussi pour la structure dans les requêtes, comment il gère l'authentification, etc...