C'est à mon sens une excellente idée, qui me trotte également dans la tête depuis quelques temps. Et en tant que dev, je serai ravi de pouvoir participer.
Simple suggestion : je vois qu'il existe deux ressources distinctes pour les représentations JSON des factures et le téléchargement du PDF. Il s'agit pourtant conceptuellement de la même ressource. Ne serait-il pas plus simple de pouvoir préciser dans le header accept le format souhaité ?
# Liste des factures en JSON
GET {apiRoot}/invoices
Accept "application/json"
# Détail d'une facture en JSON
GET {apiRoot}/invoices/{idFacture}
Accept "application/json"
# Détail d'une facture en PDF
GET {apiRoot}/invoices/{idFacture}
Accept "application/pdf"
La norme Obapi pourrait dans ce cas préciser que proposer une représentation PDF de la facture est obligatoire.
# Un grand oui
Posté par Letho . En réponse au journal Une API normée pour accéder aux factures (1ere étape). Évalué à 4. Dernière modification le 06 janvier 2023 à 16:11.
C'est à mon sens une excellente idée, qui me trotte également dans la tête depuis quelques temps. Et en tant que dev, je serai ravi de pouvoir participer.
Simple suggestion : je vois qu'il existe deux ressources distinctes pour les représentations JSON des factures et le téléchargement du PDF. Il s'agit pourtant conceptuellement de la même ressource. Ne serait-il pas plus simple de pouvoir préciser dans le header
acceptle format souhaité ?La norme Obapi pourrait dans ce cas préciser que proposer une représentation PDF de la facture est obligatoire.