Passer au contenu principal
POST
Qualifier un prospect acquéreur

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

acquisitionId
string
requis

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

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

"618a35a36d932054e195ca0a"

Corps

application/json
acquisitionStep
enum<string>
requis
Options disponibles:
ASRC,
AARC
stepUpdateReason
enum<string>

Raison d'archivage, requise pour AARC.

Options disponibles:
noFollowUp,
unreachable
activityId
string

Tâche de qualification que l'action vient clore.

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

"618a35a36d932054e195ca0a"

originMatch
object

Mise en relation à l'origine de la demande.

Réponse

Acquisition qualifiée.

success
boolean
acquisition
object

Acquisition en lecture. id, customId, agency, agencyGroup, step, createdAt, updatedAt, stepUpdatedAt, owner et mainContact sont toujours présents (si l'acquisition existe). Les autres champs sont absents s'ils ne sont pas renseignés.