Rendre découvrable les API par une machine avec une méta-API

[betagouv]

Rendre découvrable les API par une machine avec une méta-API

[MattiSG]

J’avoue, un peu 😉 C’est que cette appellation est ambigüe… Si on veut maximiser la découvrabilité du sujet, je suggère qu’on renomme l’issue en quelque chose comme « Rendre découvrable les API par une machine avec une méta-API ».

[jdesboeufs]

Est-ce qu'il y a une demande utilisateur ?

Le ven. 24 juin 2016 à 11:10, Thibaut [email protected] a écrit :

Possibilité :

• apisjson http://apisjson.org/
• json-ld http://json-ld.org/
• json-ld http://json-ld.org/ + hydra
  https://www.hydra-cg.com/spec/latest/core/

—
You are receiving this because you are subscribed to this thread.
Reply to this email directly, view it on GitHub
#142, or mute the thread
https://github.com/notifications/unsubscribe/ABLJgHTfjsfbB1j27-BygA6iDALRXFEGks5qO58UgaJpZM4I9mBR
.

[MattiSG]

Qu'entends-tu par « API sémantique » ?

[ThibautGery]

@jdesboeufs Oui on a eu une retours sur twitter et par mail sur notre API mais ce ne sont pas encore des demandes très explicites mais je préfère lancer le débat sur une future API qui va certainement arrivé d'ici peu.
@MattiSG Je sais pas si la future API de api.gouv.fr doit être sémantique mais elle doit à minima être construite intéligemment. Car pour l'instant, elle est plus ou moins inéxistante.

[MattiSG]

Ok, mais je ne sais pas ce qu'est une « API sémantique », donc dur pour moi de participer à ce débat 😉

[ThibautGery]

@MattiSG Roohhh c'est toi qui m'a parlé de ça. Tu fais ça pour m'embêter ;)
Disons qu'il faut qu'on définisse un schéma et s'il pouvait suivre un standard, ça serait mieux (comme json-ld ou même une topologie)

[MattiSG]

HATEOAS me semble un bon candidat.

[MattiSG]

Pourquoi https://api.gouv.fr/api/api-gouv ne suffit-il pas ? Je ferme cette issue tant qu'on n'a pas reçu de demande d'amélioration, comme les utilisateurs y sont invités explicitement sur la page de description.

Pas de souci pour rouvrir si j'ai mal compris l'intention.