Endpoints
Authentification : token LinkedAPI avec scope
externalIntegration. POST et PATCH exigent l’autorisation en écriture.
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 offres
data.offerDate décroissant.
En charge partagée (feeResponsibility: both), une offre saisie dans Avest peut porter la part vendeur des honoraires : data.sellerAgencyCommission, et data.sellerAgencyCommissionPercentage en mode pourcentage. Ces champs ne s’écrivent pas par l’API.
POST — créer une offre
Body Parameters
offerDate est requis, ainsi qu’au moins un de sellPrice / agencyCommission.
Statuts d’offre
Exemple
PATCH — faire évoluer une offre
Mêmes champs que le POST (tous optionnels, au moins un requis), plus les path parameters matchId et activityId. accepted y est refusé de la même manière.
En charge partagée, des honoraires (agencyCommission) inférieurs à la part vendeur enregistrée sont refusés (400) et l’offre n’est pas modifiée. Passer feeResponsibility à seller ou buyer efface la part vendeur.
Réponses d’erreur
Rate limits
GET : 500 req / minute. POST et PATCH : 100 req / minute.