Developer API
Med Seconda API kan du lägga upp annonser programmatiskt utan att öppna webbplatsen. Du behöver en API-nyckel från ditt konto.
1. Skapa en nyckel
Nycklar skapas från ditt konto, på Inställningar, API-nycklar.
Nyckeln visas bara en gång, när den skapas. Kopiera det sedan och förvara det säkert; du kan inte se det efter det.
2. Autentisera
Skicka nyckeln med varje begäran, i en av två rubriker:
Authorization: Bearer seconda_ab12cd34_...
# sau, la fel de bine:
X-API-Key: seconda_ab12cd34_...3. Skapa en annons
Skicka annonsdata i JSON-format. Priset är helt, i pengar (15000 betyder 150,00 lei). Följande är obligatoriska: titel (5-80 tecken), beskrivning (20-3000 tecken), kategori (en kategoribladssnigel) och pris (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",
"moduriLivrare": ["personal", "curier"],
"tariLivrare": ["RO"]
}'För att publicera krävs också leveransfältet: ”moduriLivrare”, med minst ett av ”personal” (personlig överlämning) och ”curier” (kurir eller post); med kurir även ”tariLivrare”, koderna för de EU-länder du skickar till (till exempel ”RO”, ”BG”). Utan det svarar publiceringen med 400 ANUNT_INVALID, och i ”eroare.detalii” står problemet LIVRARE_LIPSA (fältet ”moduriLivrare”) eller TARI_LIVRARE_LIPSA (fältet ”tariLivrare”).
Svaret innehåller annons-id:t som du behöver i nästa steg.
4. Ladda upp bilder
Skicka bilderna som flerdelade, med "bilder"-fältet upprepat för varje fil. Mellan 1 och 20 bilder, i JPEG-, PNG- eller 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. Publicera annonsen
När du har lagt till bilderna, publicera annonsen som ska visas i katalogen.
curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/publica \
-H "Authorization: Bearer CHEIA_TA"Bekräftelsemail
När du postar manuellt, från webbplatsen, får du ett bekräftelsemail för varje annons. När du postar via API:t, med en nyckel, får du inte ett e-postmeddelande med varje annons, utan en enda sammanfattning i slutet av dagen.