API partenaires
Éditeurs de logiciels immobiliers et automobiles : diffusez les annonces de vos clients sur Abracadeal, automatiquement. La diffusion est gratuite pour les agences et les garages.
Version 1 — mise à jour le 5 novembre 2026. Contact technique : contact@abracadeal.fr
Principe
- Votre client active Abracadeal dans votre logiciel. C'est son accord pour la diffusion.
- Vous déclarez l'agence (
PUT /v1/agencies/{agency_id}) avec son SIRET. - Vous envoyez ses annonces (
PUT /v1/agencies/{agency_id}/listings). Elles sont contrôlées puis mises en ligne, et mises à jour à chaque envoi.
pending et nous la traitons rapidement ; ses annonces sont ensuite acceptées sans action de votre part.Accès
URL de base
https://jplzvxmpbpjssyinozap.supabase.co/functions/v1/partner-api/v1
Authentification : une clé par éditeur, fournie sur demande à contact@abracadeal.fr, à envoyer dans chaque requête :
Authorization: Bearer abk_live_xxxxxxxxxxxxxxxx
Les échanges se font en JSON (UTF-8), en HTTPS uniquement. POST est accepté partout où PUT l'est. Une clé de test est disponible pour vos développements.
Les routes
| Méthode | Route | Rôle |
|---|---|---|
| GET | /ping | Vérifie la clé. |
| PUT | /agencies/{agency_id} | Déclare ou met à jour une agence (activation par l'agence). |
| GET | /agencies/{agency_id} | Statut de l'agence et nombre d'annonces par statut. |
| DELETE | /agencies/{agency_id} | L'agence désactive Abracadeal : toutes ses annonces sont retirées. |
| PUT | /agencies/{agency_id}/listings | Envoie des annonces (ajout, mise à jour, ou stock complet). |
| GET | /agencies/{agency_id}/listings | Liste des annonces de l'agence, avec statut et lien public. |
| DELETE | /agencies/{agency_id}/listings/{reference} | Retire une annonce (vendue, louée, mandat terminé). |
agency_id est votre identifiant de l'agence : 1 à 80 caractères parmi A-Z a-z 0-9 . _ : -.
Déclarer une agence
PUT /v1/agencies/AG-1234
{
"siret": "12345678900012",
"name": "Agence du Port",
"sector": "immobilier",
"email": "contact@agenceduport.fr",
"phone": "04 93 00 00 00",
"city": "Cannes",
"postal_code": "06400",
"consent": true
}
| Champ | Obligatoire | Description |
|---|---|---|
siret | oui | 14 chiffres. Ne peut plus changer une fois l'agence diffusée. |
name | oui | Nom commercial de l'agence. |
consent | oui | true : l'agence a activé elle-même la diffusion sur Abracadeal dans votre logiciel. |
sector | non | immobilier (par défaut) ou vehicules. |
email, phone | recommandés | Indispensables pour ouvrir automatiquement le compte de l'agence. Le téléphone est celui affiché aux acheteurs. |
city, postal_code | non | Adresse de l'agence. |
Réponse (201 à la création, 200 ensuite) :
{ "ok": true, "agency": { "agency_id": "AG-1234", "status": "active", "status_detail": "Annonces acceptées.", … } }
Statuts : active (annonces acceptées), pending (compte en cours d'ouverture par Abracadeal), stopped (diffusion arrêtée ; un nouveau PUT la relance).
Envoyer des annonces
PUT /v1/agencies/AG-1234/listings
{
"mode": "partial",
"listings": [
{
"reference": "MANDAT-0456",
"transaction": "vente",
"type_bien": "appartement",
"titre": "Appartement 3 pièces avec terrasse",
"description": "…",
"prix": 395000,
"surface": 68,
"pieces": 3,
"chambres": 2,
"ville": "Cannes",
"code_postal": "06400",
"dpe": "C",
"ges": "C",
"photos": ["https://…/1.jpg", "https://…/2.jpg"]
}
]
}
mode: "partial"(par défaut) : les annonces envoyées sont créées ou mises à jour, les autres ne bougent pas. Retirez une annonce avecDELETE …/listings/{reference}.mode: "full": vous envoyez le stock complet ; les annonces absentes de l'envoi sont retirées.- 200 annonces maximum par appel. Une annonce identique à l'envoi précédent n'est pas retraitée.
referenceest obligatoire : identifiant unique et stable du bien (numéro de mandat, de stock…). C'est lui qui relie vos mises à jour à l'annonce en ligne.
Réponse :
{ "ok": true, "mode": "partial", "received": 1, "created": 1, "updated": 0,
"unchanged": 0, "removed": 0, "rejected": 0, "rejected_detail": null }
Une annonce incomplète (sans photo, sans ville, type non reconnu…) est refusée sans bloquer les autres ; la raison figure dans rejected_detail.
Champs immobilier
Les noms français ci-dessous sont recommandés ; les équivalents anglais courants sont aussi reconnus (price, city, rooms, living_area, energy_class…).
| Champ | Description |
|---|---|
reference * | Identifiant unique et stable du bien. |
transaction * | vente ou location. |
type_bien * | appartement, maison, terrain, local commercial, bureaux, parking… |
titre, description | Texte de l'annonce. |
prix * | En euros. Loyer mensuel pour une location. |
ville *, code_postal | Commune du bien. |
surface, surface_terrain | En m². |
pieces, chambres, salles_de_bain, etage | Nombres. |
dpe, ges | Classes A à G (obligatoires pour les logements, selon la réglementation). |
honoraires, charges_mensuelles, charges_annuelles | Informations financières. |
photos * | Liste d'URL publiques (45 maximum). |
url | Lien vers l'annonce sur le site de l'agence. |
Champs véhicules
| Champ | Description |
|---|---|
reference * | Numéro de stock unique et stable. |
marque *, modele *, version | Identification du véhicule. |
prix * | En euros TTC. |
annee, kilometrage | Nombres. |
carburant, boite | essence, diesel, hybride, électrique… ; manuelle, automatique. |
type | voiture (par défaut), moto, utilitaire, camping-car… |
ville, code_postal | Par défaut, l'adresse du garage. |
photos * | Liste d'URL publiques (45 maximum). |
* champs nécessaires à la mise en ligne.
Erreurs
Toute erreur renvoie { "ok": false, "error": { "code": "…", "message": "…" } }.
| HTTP | Code | Signification |
|---|---|---|
| 401 | unauthorized | Clé absente ou invalide. |
| 404 | agency_not_found | Agence non déclarée. |
| 409 | agency_pending | Compte de l'agence en cours d'ouverture : renvoyez plus tard. |
| 409 | agency_stopped | Diffusion arrêtée par l'agence. |
| 413 | too_many | Plus de 200 annonces dans l'appel. |
| 422 | invalid_siret, consent_required, missing_reference… | Données invalides (détail dans message). |
| 502 / 500 | import_failed, server_error | Problème temporaire : réessayez plus tard. |
Exemple complet
curl -X PUT "https://jplzvxmpbpjssyinozap.supabase.co/functions/v1/partner-api/v1/agencies/AG-1234/listings" \
-H "Authorization: Bearer abk_live_xxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"mode":"partial","listings":[{"reference":"MANDAT-0456","transaction":"vente","type_bien":"maison","prix":520000,"ville":"Mougins","surface":120,"pieces":5,"dpe":"B","ges":"B","photos":["https://exemple.fr/1.jpg"]}]}'
Bon à savoir
- Les annonces passent par nos contrôles automatiques (cohérence, photos, contenus interdits) avant publication, comme toute annonce d'Abracadeal. Voir les règles de diffusion.
- Les annonces restent la propriété de l'agence. Abracadeal ne les transmet à aucun autre site.
- Vous préférez un export existant (format SeLoger / Poliris par FTP, flux XML) ? Écrivez-nous : nous pouvons aussi le lire.