API programisty

1. Dokonaj klucza

Klucze dorabiane są z Twojego konta, pod adresem Ustawienia, klucze API.

Klucz jest wyświetlany tylko raz, po utworzeniu. Skopiuj go i przechowuj w bezpiecznym miejscu; potem tego nie widać.

2. Uwierzytelnij

Wyślij klucz przy każdym żądaniu, w jednym z dwóch nagłówków:

Authorization: Bearer seconda_ab12cd34_...

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

3. Utwórz reklamę

Wyślij dane reklamy w formacie JSON. Cena jest podana w całości, w pieniądzu (15000 oznacza 150,00 lei). Obowiązkowe są: tytuł (5-80 znaków), opis (20-3000 znaków), kategoria (kategoria-ślimak liściowy) i 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"
  }'

Odpowiedź zawiera identyfikator reklamy, który będzie Ci potrzebny w kolejnych krokach.

4. Załaduj zdjęcia

Wyślij zdjęcia jako wieloczęściowe, z powtarzającym się polem "zdjęcia" dla każdego pliku. Od 1 do 20 zdjęć w formacie JPEG, PNG lub 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. Opublikuj ogłoszenie

Po dodaniu zdjęć opublikuj ogłoszenie, aby pojawiło się w katalogu.

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

E-maile z potwierdzeniem

Po ręcznym opublikowaniu postu z witryny otrzymasz e-mail z potwierdzeniem dla każdego ogłoszenia. Gdy publikujesz post za pośrednictwem interfejsu API z kluczem, nie otrzymasz wiadomości e-mail z każdą reklamą, ale na koniec dnia otrzymasz jedno podsumowanie.