API za programere

Uz Seconda API možete postavljati oglase programski, bez otvaranja web stranice. Potreban vam je API ključ sa vašeg računa.

1. Napravite ključ

Ključevi se izrađuju s vašeg računa, na Postavke, API ključevi.

Ključ se prikazuje samo jednom, prilikom kreiranja. Zatim ga kopirajte i čuvajte na sigurnom; nakon toga ne možete vidjeti.

2. Prijavite se

Pošaljite ključ uz svaki zahtjev, u jednom od dva zaglavlja:

Authorization: Bearer seconda_ab12cd34_...

# sau, la fel de bine:
X-API-Key: seconda_ab12cd34_...

3. Izradite oglas

Pošaljite podatke o oglasu u JSON formatu. Cijena je cijela, u novcu (15000 znači 150,00 leja). Sljedeće je obavezno: naslov (5-80 znakova), opis (20-3000 znakova), kategorija (kategorija-lišće) i cijena (1-100.000 leja).

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"
  }'

Odgovor sadrži ID oglasa koji vam je potreban u sljedećim koracima.

4. Učitajte slike

Pošaljite slike kao višedijelne, s poljem "slike" koje se ponavlja za svaku datoteku. Između 1 i 20 slika, u JPEG, PNG ili WebP formatu.

curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/poze \
  -H "Authorization: Bearer CHEIA_TA" \
  -F "[email protected]" \
  -F "[email protected]"

5. Objavite oglas

Nakon što dodate svoje fotografije, objavite svoj oglas da se pojavi u katalogu.

curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/publica \
  -H "Authorization: Bearer CHEIA_TA"

E-poruke potvrde

Kada objavljujete ručno, sa stranice, dobivate potvrdnu e-poruku za svaki oglas. Kada objavljujete putem API-ja, s ključem, ne dobivate e-poruku sa svakim oglasom, već jedan sažetak na kraju dana.

Kolačići u sekundi