Documentation

Synchroniser le stock

La façon la plus simple de tenir Sitigeo à jour : envoyer chaque nuit votre stock complet. Ce qui n’y est plus disparaît tout seul.

POST /v1/syncConnectez-vous pour y voir votre clé de test

curl https://api.sitigeo.com/v1/sync \
  -H "Authorization: Bearer sg_test_…" -H "Content-Type: application/json" \
  -d '{ "listings": [ { "reference": "AG-2026-118", … }, { "reference": "AG-2026-207", … } ] }'

Réponse

{
  "test": false,
  "summary": { "created": 3, "updated": 41, "rejected": 1, "removed": 2 },
  "results": [
    { "reference": "AG-2026-118", "action": "updated", "url": "https://www.sitigeo.com/fr/offre-immobiliere/…", "warnings": [] },
    { "reference": "AG-2026-301", "action": "rejected", "problems": [ { "field": "dpe", "message": "DPE obligatoire (A à G, ou NC si non soumis)" } ] }
  ]
}

Ce qui se passe

Chaque annonce de l’envoi est créée ou mise à jour. Toute annonce de l’agence encore en ligne et absente de l’envoi est retirée : c’est ce qui évite les annonces mortes. Une annonce refusée par le contrôle qualité garde sa version déjà en ligne, elle n’est pas retirée.

Garde-fous

Un envoi vide est refusé (422 sync_vide), pour qu’un flux vide par erreur ne vide jamais votre vitrine ; ajoutez "allow_empty": true si vous voulez vraiment tout retirer. Un envoi qui retire plus de la moitié de vos annonces (10 au moins) est signalé à l’agence dans son espace. 5 000 annonces au plus par envoi.

Documentation

Synchroniser le stock

La façon la plus simple de tenir Sitigeo à jour : envoyer chaque nuit votre stock complet. Ce qui n’y est plus disparaît tout seul.

POST /v1/syncConnectez-vous pour y voir votre clé de test

curl https://api.sitigeo.com/v1/sync \
  -H "Authorization: Bearer sg_test_…" -H "Content-Type: application/json" \
  -d '{ "listings": [ { "reference": "AG-2026-118", … }, { "reference": "AG-2026-207", … } ] }'

Réponse

{
  "test": false,
  "summary": { "created": 3, "updated": 41, "rejected": 1, "removed": 2 },
  "results": [
    { "reference": "AG-2026-118", "action": "updated", "url": "https://www.sitigeo.com/fr/offre-immobiliere/…", "warnings": [] },
    { "reference": "AG-2026-301", "action": "rejected", "problems": [ { "field": "dpe", "message": "DPE obligatoire (A à G, ou NC si non soumis)" } ] }
  ]
}