API v2

Publica e gere os teus anúncios a partir do teu software: API REST, webhooks e importação automática de feeds.

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à.

OAuth2 (applications tierces)

Pour agir au nom d'un membre : déclarez une application dans Mon compte → API et intégrations, puis suivez le flux « authorization code » (PKCE S256 accepté).

1. GET  https://wannonce.eu/oauth2/authorize?client_id=wc_…&redirect_uri=…&response_type=code&state=…&code_challenge=…
2. POST https://wannonce.eu/api/oauth/token   grant_type=authorization_code&client_id=wc_…&code=…&client_secret=ws_… (ou code_verifier=…)
   → {"access_token":"wa_…","token_type":"Bearer","expires_in":3600,"refresh_token":"wr_…"}
3. POST https://wannonce.eu/api/oauth/token   grant_type=refresh_token&client_id=wc_…&client_secret=ws_…&refresh_token=wr_…

Bac à sable : une application créée en mode bac à sable reçoit des jetons dont les écritures (POST, DELETE) sont validées mais jamais enregistrées ; la réponse porte "sandbox": true.

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":"…"}}

Feed de anúncios (multidifusão)

Indica o endereço do teu feed CSV ou XML: é sincronizado de hora a hora. Os anúncios que não constam do feed são retirados.

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).