Passer au contenu principal
PATCH
Faire évoluer une offre

Autorisations

Authorization
string
header
requis

Token LinkedAPI avec scope externalIntegration. La clé doit avoir un agencyGroup configuré (sinon 400 LinkedAPI agencyGroup is required). Fourni via l'en-tête Authorization: Bearer {linkedAPI_token}. Si la clé a secure === true, l'IP appelante doit être whitelistée (en-tête X-Real-IP), sinon 403 Not authorized to access this resource.

La clé porte aussi un niveau d'accès : en lecture seule, elle n'autorise que les GET ; un POST ou un PATCH renvoie alors 403 Not authorized to access this resource, soit la même réponse qu'une requête sans en-tête Authorization. Voir le guide Authentification.

Paramètres de chemin

matchId
string
requis

Identifiant Mongo (24 caractères hexadécimaux).

Pattern: ^[a-fA-F0-9]{24}$
Exemple:

"618a35a36d932054e195ca0a"

activityId
string
requis

Identifiant Mongo (24 caractères hexadécimaux).

Pattern: ^[a-fA-F0-9]{24}$
Exemple:

"618a35a36d932054e195ca0a"

Corps

application/json

À la création, offerDate est requis ainsi qu'au moins un de sellPrice / agencyCommission. En mise à jour, au moins un champ.

offerDate
string<date-time>
sellPrice
number
agencyCommission
number
status
enum<string>

accepted est refusé sur l'API externe.

Options disponibles:
transmitted,
received,
rejected,
rejected_counter_offer,
withdrawn,
cancelled
feeResponsibility
string
financing
string
deposit
number
counterOfferAmount
number
content
string
owner
string

Identifiant Mongo (24 caractères hexadécimaux).

Pattern: ^[a-fA-F0-9]{24}$
Exemple:

"618a35a36d932054e195ca0a"

Réponse

Offre mise à jour.

success
boolean
offer
object

Activité liée à un document Avest (note, tâche, appel, email, changement d'étape, etc.).