Pour lire les visites, préférez
GET .../visits à
GET Activities : la réponse est déjà filtrée sur
les visites, triée par date de visite, et enrichie d’un derivedStatus.Endpoints
Authentification : token LinkedAPI avec scope
externalIntegration. Les routes POST et PATCH exigent l’autorisation en écriture sur ce scope — un token en lecture seule reçoit 403 Not authorized to access this resource.
Clé requise : GET avec toutes les clés ; POST et PATCH en lecture-écriture (une clé en lecture seule reçoit 403). Voir Types de clé.
Headers
GET — lister les visites
Path Parameters
Réponse
data.visitStartAt décroissant (la plus récente d’abord).
data.derivedStatus
Calculé par Avest à la lecture, il évite de recalculer l’état côté client :
POST — créer une visite
Body Parameters
Si
owner est absent, la visite est attribuée au responsable du match.
Exemple
201 :
PATCH — modifier ou annuler une visite
Path Parameters
Body Parameters
Au moins un champ doit être fourni.Il n’y a pas de suppression de visite via l’API. L’annulation
(
isCancelled: true) couvre le besoin et reste réversible ; elle conserve
l’historique côté agent.Réponses d’erreur
Un match hors périmètre répond « Unable to find match » : aucune différence n’est faite entre « n’existe pas » et « pas autorisé ».
Rate limits
GET : 500 req / minute. POST et PATCH : 100 req / minute (bucket d’écriture partagé avec les autres routes en écriture).
Headers sur toutes les réponses : RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.