Lire une opération bancaire
GET/api/v1/bank_operations/:id
Retourne une seule opération bancaire. Le chemin ne porte aucun espace de travail : l'identifiant est résolu sur l'ensemble des espaces de travail sur lesquels votre jeton porte une habilitation, et une opération hors de ceux-ci ne se distingue pas d'une opération inexistante.
projection est le champ à lire après la validation d'un relevé - il dit si la ligne a atteint le grand livre, et projection.exported si cette écriture en est depuis sortie. Les deux sont calculés à chaque lecture plutôt que stockés.
Request
Responses
- 200
- 401
- 403
- 404
L'opération bancaire.
La requête ne porte aucun jeton, ou un jeton invalide ou expiré.
Deux causes, de part et d'autre de la résolution de l'enregistrement. LE SCOPE OAuth est vérifié EN PREMIER, avant que cette opération soit résolue : un GET exige read, et un jeton portant seulement write ou destroy est refusé ici même pour un identifiant inexistant ou que vous n'auriez de toute façon pas pu lire - un 403 sur un GET mérite donc d'être écarté avant d'aller chercher un problème de droits sur l'enregistrement. L'autre cause est la FONCTIONNALITÉ bank_reconciliation désactivée pour l'espace de travail auquel l'opération appartient, et celle-là est bien tranchée après l'accessibilité : une opération que votre jeton ne peut pas lire répond 404, jamais 403, si bien que ce statut ne confirme jamais qu'un identifiant existe hors de vos habilitations. L'exemple ci-dessous est refusé par la fonctionnalité.
Aucune opération portant cet identifiant n'est accessible aux habilitations du jeton. Une opération appartenant à un autre espace de travail répond de la même manière, si bien que la réponse ne permet pas d'en sonder l'existence.