API pentru dezvoltatori

1. Fă o cheie

Cheile se fac din contul tău, la Setări, Chei de API.

Cheia se arată o singură dată, la creare. Copiaz-o atunci și ține-o la loc sigur; nu o mai poți vedea după aceea.

2. Autentifică-te

Trimite cheia la fiecare cerere, într-unul din cele două antete:

Authorization: Bearer seconda_ab12cd34_...

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

3. Creează un anunț

Trimite datele anunțului în format JSON. Prețul e întreg, în bani (15000 înseamnă 150,00 lei). Sunt obligatorii: titlul (5-80 de semne), descrierea (20-3000 de semne), categoria (un slug de categorie-frunză) și prețul (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"
  }'

Răspunsul conține id-ul anunțului, de care ai nevoie la pașii următori.

4. Încarcă poze

Trimite pozele ca multipart, cu câmpul „poze” repetat pentru fiecare fișier. Între 1 și 20 de poze, în format JPEG, PNG sau 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. Publică anunțul

După ce ai adăugat pozele, publică anunțul ca să apară în catalog.

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

E-mailuri de confirmare

Când postezi manual, din site, primești un e-mail de confirmare pentru fiecare anunț. Când postezi prin API, cu o cheie, nu primești un e-mail la fiecare anunț, ci un singur rezumat la sfârșitul zilei.