Developer API

Pomocou rozhrania Seconda API môžete uverejňovať reklamy programovo, bez otvárania webovej stránky. Potrebujete kľúč API zo svojho účtu.

1. Vytvorte kľúč

Kľúče sa vytvárajú z vášho účtu, v časti Nastavenia, Kľúče API.

Kľúč sa pri vytváraní zobrazí iba raz. Potom ho skopírujte a uschovajte; potom to uz nevidno.

2. Autentifikácia

Pošlite kľúč s každou požiadavkou v jednej z dvoch hlavičiek:

Authorization: Bearer seconda_ab12cd34_...

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

3. Vytvorte reklamu

Pošlite údaje reklamy vo formáte JSON. Cena je celá, v peniazoch (15000 znamená 150,00 lei). Nasledujúce sú povinné: názov (5-80 znakov), popis (20-3000 znakov), kategória (kategória-listový slimák) a 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"
  }'

Odpoveď obsahuje ID reklamy, ktoré potrebujete v ďalších krokoch.

4. Odovzdajte obrázky

Pošlite obrázky ako viacdielne, pričom pole „obrázky“ sa opakuje pre každý súbor. 1 až 20 obrázkov vo formáte JPEG, PNG alebo 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. Zverejnite inzerát

Po pridaní obrázkov uverejnite inzerát, aby sa objavil v katalógu.

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

E-maily s potvrdením

Pri manuálnom odoslaní príspevku zo stránky dostanete e-mail s potvrdením pre každú reklamu. Keď uverejňujete príspevok cez API s kľúčom, nedostanete e-mail s každou reklamou, ale na konci dňa jedno zhrnutie.

Cookies za sekundu