API : API proposée

Pour l’API : API proposée je me suis dit que REST étant une API ce serait interessant de voir ce qui l’utilise et j’ai trouvé OpenStreetMap API et la façon dont s’est organisé me laisse un peu perplexe. En particulier il n’y a pas de lien fait avec OpenStreetMap alors que ça devrait, non ?

Je pense que le lien doit etre « part of » et j’ai documenté avec OSM API en exemple. Par ailleurs j’ai demandé un avis sur l’opportunité d’avoir une property API au lieu de part of parceque ça serait plus explicite.

Juste pour info, tu connais Linked Open Vocabulary qui te permet de faire des recherches dans des ontologies existantes : http://lov.okfn.org/dataset/lov/terms?q=API (bon malheureusement il ne filtre pas sur le mot uniquement :-/)

@alexg je ne connaissais pas, merci :slight_smile: Tu utiliserais ça comment pour cette question particulière de l’API ?

L’idée c’est de voir s’il y a déjà une propriété API dans un langage existant. Ou regarder si dans les ontologies (vocabs) existant, l’un d’eux traite de l’informatique.
Coté liste de propriétés, malheureusement l’outil de recherche ramène tous les mots qui contiennent « api » ce qui fait trop de résultats.
J’ai vu http://lov.okfn.org/dataset/lov/vocabs/odapp mais qui est très pauvre et ne parle pas d’API.
Il y a aussi http://lov.okfn.org/dataset/lov/vocabs/doap qui est bien connu (utilisé par exemple sur pypi) et, dans sa définition, je vois une propriété service-endpoint qui correspond (peut-être) à ce que tu veux. Je vois aussi un vendor qui peut correspondre à la référence à l’organisation.

Après je ne connais pas bien la politique de wikidata et si tu es libre comme ça de faire référence a n’importe quelle ontologie (je serais cependant surpris que DOAP ne soit pas considéré).

Oui, ça s’en rapproche. Je ne vois pas comment trouver une explication plus approfondie de la signification de service-endpoint. Je trouve indirectement que WSDL est pertinent mais je m’attendrais à avoir des pages spécifiques à DOAP ? Je dois rater un truc gros comme une maison: les discussions qui ont conduit à la définition de ce terme :slight_smile: