Project

General

Profile

Development #35361

api_entreprise: permettre de savoir si un document d'association d'un type particulier existe

Added by Serghei Mihai 10 days ago. Updated 1 day ago.

Status:
Solution proposée
Priority:
Normal
Assignee:
Target version:
-
Start date:
12 Aug 2019
Due date:
% Done:

0%

Patch proposed:
Yes
Planning:
No

Description

Pour avoir un referentiel

0001-api_entreprise-add-endpoint-to-get-last-document-of-.patch View (4.85 KB) Serghei Mihai, 21 Aug 2019 11:26 AM

History

#2 Updated by Benjamin Dauvergne 10 days ago

Ç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.

#3 Updated by Serghei Mihai 10 days ago

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.

#4 Updated by Benjamin Dauvergne 10 days ago

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.

#5 Updated by Serghei Mihai 10 days ago

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.

#6 Updated by Benjamin Dauvergne 10 days ago

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 ?

#7 Updated by Serghei Mihai 9 days ago

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.

#8 Updated by Serghei Mihai 9 days ago

  • Subject changed from api_entreprise: listes les types de documents d'association to api_entreprise: permettre de savoir si un document d'association d'un type particulier existe

#9 Updated by Benjamin Dauvergne 9 days ago

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" 
   }
}

#10 Updated by Serghei Mihai 1 day ago

Yep.

Also available in: Atom PDF