Skip to main content
Request an on-demand check of an advert
POST /v2/protected/adverts/{flxId}/check répond à une seule question : cette annonce est-elle toujours en ligne sur son portail ? L’appel n’a aucun corps de requête ni paramètre de requête : seul le flxId du chemin est nécessaire. Il répond 200 immédiatement, le contrôle est lancé en tâche de fond. Le contrat exact est documenté plus bas par le bloc OpenAPI (POST /v2/protected/adverts/{flxId}/check).
L’appel coûte 1 crédit, facturé sur toute réponse 2xx. Un 404 ne facture rien. Suivez votre solde avec la consommation de crédits.
Ce contrôle porte sur la disponibilité, pas sur le contenu. Il met à jour le statut en ligne de l’annonce ; il ne corrige ni le prix, ni la surface, ni la géolocalisation, ni l’agence. Pour faire corriger une donnée fausse, utilisez /report avec le motif adéquat — c’est gratuit et plus efficace.
Le résultat n’est pas dans la réponse. Relisez l’annonce quelques minutes plus tard avec GET /v2/protected/adverts/{flxId}, ou recevez-la sur votre webhook d’alerte. L’annonce est contrôlée même si Fluximmo la croit hors ligne — c’est justement le cas qui permet de la faire repasser en ligne.

/check ou /report ?

  • /check — « est-elle toujours en ligne ? » : vous n’avez pas de diagnostic, vous voulez confirmer la disponibilité. Payant (1 crédit), sans corps de requête.
  • /report — nous dire ce qui ne va pas : vous avez un diagnostic (STILL_ONLINE, WRONG_DATA, DUPLICATE…). Gratuit, avec motif obligatoire. Et le motif détermine la profondeur : un problème de disponibilité déclenche le même contrôle léger que /check, tandis qu’un problème de donnée déclenche une réextraction complète de l’annonce.

Cas d’usage

  • Avant d’afficher une fiche — confirmer qu’une annonce vue il y a plusieurs jours est toujours publiée avant de la présenter à un utilisateur final.
  • Confirmation de disponibilité — vérifier qu’une annonce est toujours publiée avant de déclencher une prise de contact.
  • Rattrapage ciblé — revérifier un petit lot d’annonces sensibles sans attendre le cycle de collecte automatique.

Exemples

1 — Demander la revérification

Réponse 200 :
status vaut accepted ou nothing_to_check. triggered liste les flx_id confiés au scraper. Sur une annonce, skipped_count ne peut valoir que 0 ou 1 : il passe à 1 lorsque la revérification n’a pas pu être lancée, et status vaut alors nothing_to_check. Une rafale d’appels rapprochés rend ce cas plus probable — espacez-les et réessayez. Le plafond de 10 annonces et le cas « url source absente » ne concernent que les properties. Le crédit est débité dans les deux cas, puisque la réponse est un 2xx.

2 — Revérifier, puis relire la donnée

Le 200 ne contient pas l’annonce : il faut la relire quelques minutes plus tard.
Si vous êtes abonné à une alerte qui couvre cette annonce, l’étape 2 est inutile : la mise à jour arrive sur votre webhook.

Erreurs spécifiques

Les réponses en succès sont enveloppées dans { "data": … }, les erreurs dans { "error": { "message", "code" } }.
  • 404flx_id inconnu : {"error":{"message":"Advert with flx_id 123456789 not found","code":10003}}. Aucun crédit débité.
  • 422 (code 10003) — l’annonce n’a pas d’url source exploitable : "Advert with flx_id 123456789 has no source url: it cannot be re-checked." Il n’y a pas d’erreur de validation de corps sur cette route, puisqu’elle n’en prend pas.
Détail des codes : Codes d’erreur.

Liens utiles

Clé test gratuite — 1 semaine

Créez un compte sur my.fluximmo.io pour récupérer une clé API test gratuite (1 semaine, accès limité). Aucun paiement requis.

Authorizations

x-api-key
string
header
required

Path Parameters

flxId
string
required

Response

data
object