API za razvijalce

Z API-jem Seconda lahko oglase objavljate programsko, brez odpiranja spletnega mesta. Potrebujete ključ API iz svojega računa.

1. Ustvarite ključ

Ključi so narejeni iz vašega računa, na Nastavitve, API ključi.

Ključ je prikazan samo enkrat, ob ustvarjanju. Nato ga kopirajte in shranite na varno; potem tega ne moreš videti.

2. Preverjanje pristnosti

Pošljite ključ z vsako zahtevo v eni od dveh glav:

Authorization: Bearer seconda_ab12cd34_...

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

3. Ustvarite oglas

Pošljite podatke o oglasu v formatu JSON. Cena je cela, v denarju (15000 pomeni 150,00 lei). Obvezni so: naslov (5-80 znakov), opis (20-3000 znakov), kategorija (kategorija-listni polž) in cena (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"
  }'

Odgovor vsebuje ID oglasa, ki ga potrebujete v naslednjih korakih.

4. Naložite slike

Pošljite slike kot večdelne, pri čemer se polje "slike" ponovi za vsako datoteko. Med 1 in 20 slikami v formatu JPEG, PNG ali 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. Objavite oglas

Po dodajanju slik objavite oglas za prikaz v katalogu.

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

Potrditvena e-pošta

Ko objavite ročno s spletnega mesta, prejmete potrditveno e-poštno sporočilo za vsak oglas. Ko objavljate prek API-ja s ključem, ne prejmete e-pošte z vsakim oglasom, ampak en sam povzetek na koncu dneva.

Piškotki na sekundo