API per sviluppatori
Con la Seconda API puoi pubblicare annunci in modo programmatico, senza aprire il sito web. Hai bisogno di una chiave API dal tuo account.
1. Crea una chiave
Le chiavi vengono effettuate dal tuo account, all'indirizzo Impostazioni, chiavi API.
La chiave viene mostrata una sola volta, al momento della creazione. Copiatelo quindi e tenetelo al sicuro; non puoi vederlo dopo.
2. Accedi
Invia la chiave con ogni richiesta, in una delle due intestazioni:
Authorization: Bearer seconda_ab12cd34_...
# sau, la fel de bine:
X-API-Key: seconda_ab12cd34_...3. Crea un annuncio
Invia i dati degli annunci in formato JSON. Il prezzo è intero, in denaro (15000 significa 150,00 lei). Sono obbligatori: titolo (5-80 caratteri), descrizione (20-3000 caratteri), categoria (una lumaca foglia di categoria) e prezzo (1-100.000 lei).
curl -X POST https://seconda.ro/api/v1/articole \
-H "Authorization: Bearer CHEIA_TA" \
-H "Content-Type: application/json" \
-d '{
"titlu": "Rochie de vara",
"descriere": "Rochie usoara din bumbac, purtata de doua ori, marimea M.",
"categorie": "femei-rochii",
"pret": 15000,
"moneda": "RON"
}'La risposta contiene l'ID annuncio, di cui avrai bisogno nei passaggi successivi.
4. Carica le foto
Invia le immagini in più parti, con il campo "immagini" ripetuto per ogni file. Da 1 a 20 immagini, in formato JPEG, PNG o WebP.
curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/poze \
-H "Authorization: Bearer CHEIA_TA" \
-F "[email protected]" \
-F "[email protected]"5. Pubblica l'annuncio
Dopo aver aggiunto le tue foto, pubblica il tuo annuncio affinché appaia nel catalogo.
curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/publica \
-H "Authorization: Bearer CHEIA_TA"E-mail di conferma
Quando pubblichi manualmente, dal sito, ricevi un'email di conferma per ogni annuncio. Quando pubblichi tramite l'API, con una chiave, non ricevi un'e-mail con ogni annuncio, ma un unico riepilogo a fine giornata.