API v2
Publish and manage your listings from your own software: REST API, webhooks and automatic feed import.
Authentification
curl -H "Authorization: Bearer wk_…" https://wannonce.eu/api/v2/listings
Quota : 5000 requêtes / jour / clé. En-têtes X-RateLimit-Limit et X-RateLimit-Remaining sur chaque réponse ; 429 au-delà.
Endpoints
| GET | /api/v2/listings | Vos annonces (tous statuts) |
| POST | /api/v2/listings | Créer une annonce (JSON : title, description, price, category, place, external_ref…) |
| GET | /api/v2/listings/{pid} | Détail d'une de vos annonces |
| DELETE | /api/v2/listings/{pid} | Supprimer |
| GET | /api/v2/categories | Arbre des catégories (slugs) |
Webhooks
Événements listing.published et message.received, envoyés en POST JSON à votre URL. Signature : en-tête X-Wannonce-Signature: sha256=… (HMAC-SHA256 du corps avec votre secret).
{"event":"listing.published","created_at":"2026-09-30T10:00:00Z","data":{"pid":"…","title":"…","url":"…"}}
Listing feed (multi-broadcast)
Provide your CSV or XML feed address: it is synced every hour. Listings missing from the feed are removed.
external_ref,title,description,price,category,place,contact_name,contact_email,contact_phone REF-001,Peugeot 208 GT Line,"Première main, 85 000 km",12500,voitures,lyon,Garage Martin,contact@garage.fr,
XML : <listings><listing><external_ref>…</external_ref><title>…</title>…</listing></listings> (mêmes noms de champs).