Passer au contenu principal
GET
Rechercher des annonces (paginé)

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 requête

transaction
string

Identifiant Mongo de la transaction liée. Identifiant Mongo (24 caractères hexadécimaux).

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

"618a35a36d932054e195ca0a"

status
enum<string>

Statut de diffusion de l'annonce. Statut de diffusion d'une annonce.

Options disponibles:
online,
offline,
archived
page
integer
défaut:1

Page 1-indexée. Défaut 1.

Plage requise: x >= 1

Réponse

Liste paginée d'annonces.

success
boolean
ads
object[]
page
integer
pageSize
integer

Taille de page (fixe, non paramétrable). ⚠️ Ce champ s'appelle pageSize ici, mais limit sur /contacts, /users et /{transaction}/search — deux noms pour la même chose, historique et conservé pour ne pas casser les intégrations existantes.

hasMore
boolean