API за разработчици

1. Направете ключ

Ключовете се правят от вашия акаунт, при Настройки, API ключове.

Ключът се показва само веднъж, при създаване. След това го копирайте и го пазете; не можете да го видите след това.

2. Влезте

Изпращайте ключа с всяка заявка в една от двете заглавки:

Authorization: Bearer seconda_ab12cd34_...

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

3. Създайте реклама

Изпратете рекламни данни във формат JSON. Цената е цяла, в пари (15000 означава 150.00 леи). Следните са задължителни: заглавие (5-80 символа), описание (20-3000 знака), категория (категория-листо) и цена (1-100 000 леи).

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

Отговорът съдържа идентификатора на рекламата, който ви е необходим в следващите стъпки.

4. Качете снимки

Изпратете снимките като съставна част, като полето "снимки" се повтаря за всеки файл. Между 1 и 20 снимки във формат JPEG, PNG или 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. Публикувайте обявата

След като добавите вашите снимки, публикувайте рекламата си, за да се появи в каталога.

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

Имейли за потвърждение

Когато публикувате ръчно, от сайта, получавате имейл за потвърждение за всяка реклама. Когато публикувате през API, с ключ, не получавате имейл с всяка реклама, а едно резюме в края на деня.