Project

General

Profile

Project management #14174

Rayonnement des web-services

Added by Benjamin Dauvergne over 3 years ago. Updated over 3 years ago.

Status:
Nouveau
Priority:
Normal
Category:
-
Target version:
-
Start date:
30 Nov 2016
Due date:
31 Jan 2017
% Done:

0%

Patch proposed:
No
Planning:
No
Demande du club utilisateur:
No

Description

quand une API existe quelque part, la rendre utilisable par les gens.

Diffusion:
  • chaque application a un /.well-known/apis = "wsdl" en JSON (dont nous devons définir le format)
  • chaque consommateur interroge les autres autour de lui pour savoir ce qu'il propose...
Description de premier niveau: décrire les API de façon "fonctionnelle", ie qualifiée, ie son type :
  • "cette BASE_URL propose une API compatible «newsletters»"
  • "cette BASE_URL propose une API compatible «factures»"
  • "cette BASE_URL propose une API compatible «datasources»"
  • famille
  • appairage
  • agendas
  • SIG (aka nominatim & référentiels d'adresses)
  • SMS
  • gestion de panier

fournir un type, une URL et un slug ex.: passerelle:spreadsheet-rue

Description de deuxième niveau pour w.c.s.:
  • libellé
  • endpoint (uri)
  • parametres query-string et/ou payload (+ libellés)
  • méthode HTTP
  • codes de retour / libellés
  • callback/trigger (+ libellés)

Point de vigilance : il y a des API qui nécessitent des valeurs dans l'URI, il faudra leur ajouter des variantes avec les valeurs dans la query-string et/ou le payload.

Chaque chose référencée doit avoir une référence qui sera la même en recette et en prod.

Amélioration dans combo : utiliser ces descriptions pour simplifier la configuration de cellules nécessitant une URL, utiliser le slug à l'import pour retrouver la bonne URL

Amélioration dans w.c.s. appel de web-service : proposer des actions de haut niveau à partir des descriptions

Amélioration dans passerelle : proposer le endpoint de description, ajouter un support au décorateur endpoint pour permettre de déclarer une description, sinon avoir une méthode get_api_description() sur la ressource, dans le cas d'un endpoint complexe (CsvDatasource.select) poser un get_select_api_description().

Amélioration dans chrono : publier description des endpoints des agendas

Amélioration dans corbo : publier description des endpoints des newsletters

Amélioration dans authentic : publier description pour endpoints « Créer un utilisateur », « Envoyer un/rappel du/changement du mot de passe», «Enregistrement», « Modifier un utilisateur ».


Subtasks

Project management #14175: Définir format de description des web-servicesNouveauThomas Noël


Related issues

Related to w.c.s. - Development #14176: Génération d'actions de workflow "haut-niveau" à partir des descriptions du rayonnement Publik Nouveau 30 Nov 2016
Related to Passerelle - Development #14177: Ajouter la déclaration d'une description pour le rayonnement au décorateur @endpoint Nouveau 30 Nov 2016
Related to Passerelle - Development #14178: Ajouter description de rayonnement aux APIs SMS Nouveau 30 Nov 2016
Related to Passerelle - Bug #14179: Ajouter description de rayonnement aux APIs source de donnée CSV Nouveau 30 Nov 2016
Related to Passerelle - Development #14180: Ajouter description de rayonnement aux APIs SIG Nouveau 30 Nov 2016
Related to Passerelle - Development #14181: Ajouter un endpoint de description des web-services pour le rayonnement Nouveau 30 Nov 2016
Related to Corbo - Development #14183: Ajouter un endpoint de description des web-services pour le rayonnement Nouveau 30 Nov 2016
Related to Chrono - Development #14184: Ajouter un endpoint de description des web-services pour le rayonnement Nouveau 30 Nov 2016
Related to Combo - Project management #14185: Utiliser les descriptions de web-service dans les cellules demandant une URL Nouveau 30 Nov 2016
Related to Authentic 2 - Development #14186: Ajouter un endpoint de description des web-services pour le rayonnement Nouveau 30 Nov 2016
Related to w.c.s. - Development #14203: Génération de sources de données à partir des infos de rayonnement Nouveau 03 Dec 2016
Related to Publik - Development #7850: alimenter automatiquement les sources de données/webservices wcs avec les connecteurs passerelle & chrono (rayonnement) Nouveau 14 Jul 2015

History

#1 Updated by Benjamin Dauvergne over 3 years ago

  • Tracker changed from Bug to Project management

#2 Updated by Benjamin Dauvergne over 3 years ago

  • Due date set to 31 Mar 2017

#3 Updated by Benjamin Dauvergne over 3 years ago

Il faudrait aussi définir une API (dans hobo?) pour simplifier le moissonnage et la recherche d'un API.

#4 Updated by Benjamin Dauvergne over 3 years ago

  • Related to Development #14176: Génération d'actions de workflow "haut-niveau" à partir des descriptions du rayonnement Publik added

#5 Updated by Benjamin Dauvergne over 3 years ago

  • Related to Development #14177: Ajouter la déclaration d'une description pour le rayonnement au décorateur @endpoint added

#6 Updated by Benjamin Dauvergne over 3 years ago

#7 Updated by Benjamin Dauvergne over 3 years ago

  • Related to Bug #14179: Ajouter description de rayonnement aux APIs source de donnée CSV added

#8 Updated by Benjamin Dauvergne over 3 years ago

#9 Updated by Benjamin Dauvergne over 3 years ago

  • Related to Development #14181: Ajouter un endpoint de description des web-services pour le rayonnement added

#10 Updated by Benjamin Dauvergne over 3 years ago

  • Related to Development #14183: Ajouter un endpoint de description des web-services pour le rayonnement added

#11 Updated by Benjamin Dauvergne over 3 years ago

  • Related to Development #14184: Ajouter un endpoint de description des web-services pour le rayonnement added

#12 Updated by Benjamin Dauvergne over 3 years ago

#13 Updated by Benjamin Dauvergne over 3 years ago

  • Related to Development #14186: Ajouter un endpoint de description des web-services pour le rayonnement added

#14 Updated by Frédéric Péters over 3 years ago

  • Related to Development #14203: Génération de sources de données à partir des infos de rayonnement added

#15 Updated by Frédéric Péters over 1 year ago

  • Related to Development #7850: alimenter automatiquement les sources de données/webservices wcs avec les connecteurs passerelle & chrono (rayonnement) added

Also available in: Atom PDF