Ontwikkelaars-API

Met de Seconda API kunt u programmatisch advertenties plaatsen, zonder de website te openen. U heeft een API-sleutel uit uw account nodig.

1. Maak een sleutel

Sleutels worden gemaakt vanuit uw account, op Instellingen, API-sleutels.

De sleutel wordt slechts één keer weergegeven, bij het maken ervan. Kopieer het dan en bewaar het veilig; daarna kun je het niet meer zien.

2. Authenticeer

Verzend de sleutel bij elk verzoek, in een van de twee headers:

Authorization: Bearer seconda_ab12cd34_...

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

3. Maak een advertentie

Verzend de advertentiegegevens in JSON-indeling. De prijs is geheel, in geld (15.000 betekent 150,00 lei). Het volgende is verplicht: titel (5-80 tekens), beschrijving (20-3000 tekens), categorie (een categoriebladslak) en prijs (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"
  }'

Het antwoord bevat de advertentie-ID, die u nodig heeft in de volgende stappen.

4. Afbeeldingen uploaden

Verzend de afbeeldingen als meerdere delen, waarbij het veld "afbeeldingen" voor elk bestand wordt herhaald. Tussen 1 en 20 foto's, in JPEG-, PNG- of WebP-formaat.

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

5. Publiceer de advertentie

Nadat u de afbeeldingen heeft toegevoegd, publiceert u de advertentie zodat deze in de catalogus verschijnt.

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

Bevestigings-e-mails

Wanneer u handmatig berichten plaatst vanaf de site, ontvangt u voor elke advertentie een bevestigings-e-mail. Wanneer je via de API post, met een sleutel, ontvang je niet bij elke advertentie een e-mail, maar aan het eind van de dag een samenvatting.

Cookies op Seconda