Produits Entr'ouvert » Passerelle

Ça ne me semble pas nécessaire pour la demande de Arles, il suffit d'avoir un argument type au endpoint et trier le résultat filtrer par ordre anti-chronologique, les types on les connaît (ou si on les connaît pas on ne risque pas de les demander).

Par contre on peut afficher la liste des types connus dans le résumé du connecteur, c'est de la doc en ligne.

Benjamin Dauvergne a écrit :

Ça ne me semble pas nécessaire pour la demande de Arles, il suffit d'avoir un argument type au endpoint et trier le résultat filtrer par ordre anti-chronologique, les types on les connaît (ou si on les connaît pas on ne risque pas de les demander).

Je suis d'accord avec toi.
En revanche, comme certains documents n'ont pas de type, il me semble impossible de garantir que tous les types définis dans la doc soient présents pour une association donnée.
D'ou l'idée de pouvoir le lister.

Serghei Mihai a écrit :

Benjamin Dauvergne a écrit :

Ça ne me semble pas nécessaire pour la demande de Arles, il suffit d'avoir un argument type au endpoint et trier le résultat filtrer par ordre anti-chronologique, les types on les connaît (ou si on les connaît pas on ne risque pas de les demander).

Je suis d'accord avec toi.
En revanche, comme certains documents n'ont pas de type, il me semble impossible de garantir que tous les types définis dans la doc soient présents pour une association donnée.
D'ou l'idée de pouvoir le lister.

Soyons clairs, les documents qui n'ont pas de type on ne les récupérera pas, il y a une limite à la quantité de travail qu'on peut appliquer à une solution mal branlée. Le but c'est quand même d'avoir un système automatique "dites-le nous une fois" pas de proposer aux agents ou aux usagers d'explorer les méandres tortueux d'api-entreprise. Si un document n'a pas de type et s'appelle juste "StAtUt-deux-mille-dix-neuf.pdf" tant pis hein, ou alors on fait d'api-entreprise un backend à fargo où les association vont chercher leur document mais ça change complètement d'approche.

Benjamin Dauvergne a écrit :

Soyons clairs, les documents qui n'ont pas de type on ne les récupérera pas, il y a une limite à la quantité de travail qu'on peut appliquer à une solution mal branlée. Le but c'est quand même d'avoir un système automatique "dites-le nous une fois" pas de proposer aux agents ou aux usagers d'explorer les méandres tortueux d'api-entreprise. Si un document n'a pas de type et s'appelle juste "StAtUt-deux-mille-dix-neuf.pdf" tant pis hein, ou alors on fait d'api-entreprise un backend à fargo où les association vont chercher leur document mais ça change complètement d'approche.

Bien sûr: on ne récupère pas les documents sans type.
Mais je trouve d'avoir un moyen de lister les types de docs pour une asso, au lieu de retourner une 404 parce qu'on a demandé la liste des dirigeants alors qu'elle n'existe pas.

Personne ne dit de retourner 404, faut juste un endpoint qui renvoie True or False et ainsi dans une condition on peut mettre webservice.association_has_liste_dirigeant.value sinon avec une liste il faudrait écrire bool([x for x in webservice.association_liste_document if x['type'] == 'Liste des dirigeants']) non ?

Tu vois comment pour que ce soit simple à utiliser dans w.c.s. avec un truc qui renvoie une liste plutôt que de renvoyer oui/non ou le fichier ?

D'accord avec toi sur un webservice signalant qu'un document de tel type existe et un autre pour retourner le dernier document de ce type.

Si tu renvoies le descriptif du document avec l'URL de téléchargement plutôt que juste true/false ça devrait suffire.

GET /api_entreprise/slug/documents_association/W09343434/get-last/?type=Statuts
Accept: application/json

Content-Type: application/json

{
   "err": 0,
   "data": {
       "id": "whatever",
       "type": "Statuts",
       "text": "whatever",
       "url": "https://passerelle/api_entreprise/slug/W3434344/ishdfisidhfisdf/",
       "timestamp": "2019-04-05" 
   }
}

On ne met pas de virgule avant trois petits points.

Perso côté code je 1/ ferais documents = [x for x in whatever if type == le type], puis 2/ documents.sort(key=...), puis 3/ return documents[-1].

C'est particulièrement pour le tri, qui est rendu ainsi beaucoup plus explicite.

Serghei Mihai a écrit :

Frédéric Péters a écrit :

On ne met pas de virgule avant trois petits points.

Je vais faire un patch à part pour changer partout pour éviter à faire des traductions avec et sans virgule.

Ce que voulait Frédéric c'est corriger dès à présent dans ce patch :

  'Description': _('request object (form number, file identifier, ...)'),   →  request object: form number, file identifier...
  'description': _('request context (MPS, APS, ... )'),                     →  request context: MPS, APS...

Tiens on note d'ailleurs une erreur ici, un D majuscule sur la première description.

Sinon je parle mal anglais mais je crois que plus personne ne se fatigue à écrire 's comme dans « association's SIREN », tu peux directement écrire « association SIREN or RNA/WALDEC number » et zou (ok on s'en fout pas mal, ça sera jamais lu en anglais de toute façons)