API für Entwickler

Mit der Seconda-API können Sie Anzeigen programmgesteuert schalten, ohne die Website öffnen zu müssen. Sie benötigen einen API-Schlüssel von Ihrem Konto.

1. Machen Sie einen Schlüssel

Die Schlüssel werden von Ihrem Konto an erstellt Einstellungen, API-Schlüssel.

Der Schlüssel wird nur einmal bei der Erstellung angezeigt. Kopieren Sie es dann und bewahren Sie es sicher auf; danach kann man es nicht mehr sehen.

2. Melden Sie sich an

Senden Sie den Schlüssel bei jeder Anfrage in einem von zwei Headern:

Authorization: Bearer seconda_ab12cd34_...

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

3. Erstellen Sie eine Anzeige

Senden Sie Anzeigendaten im JSON-Format. Der Preis ist ganz in Geld (15000 bedeutet 150,00 Lei). Folgendes ist obligatorisch: Titel (5-80 Zeichen), Beschreibung (20-3000 Zeichen), Kategorie (ein Kategorieblatt-Slug) und Preis (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"
  }'

Die Antwort enthält die Anzeigen-ID, die Sie in den nächsten Schritten benötigen.

4. Bilder hochladen

Senden Sie die Bilder als Multipart, wobei das Feld „Bilder“ für jede Datei wiederholt wird. Zwischen 1 und 20 Bilder im JPEG-, PNG- oder WebP-Format.

curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/poze \
  -H "Authorization: Bearer CHEIA_TA" \
  -F "[email protected]" \
  -F "[email protected]"

5. Veröffentlichen Sie die Anzeige

Nachdem Sie Ihre Fotos hinzugefügt haben, veröffentlichen Sie Ihre Anzeige, damit sie im Katalog erscheint.

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

Bestätigungs-E-Mails

Wenn Sie manuell auf der Website posten, erhalten Sie für jede Anzeige eine Bestätigungs-E-Mail. Wenn Sie über die API mit einem Schlüssel posten, erhalten Sie nicht mit jeder Anzeige eine E-Mail, sondern am Ende des Tages eine einzelne Zusammenfassung.

Cookies auf Seconda