API for udviklere
Med Seconda API kan du sende annoncer programmatisk uden at åbne hjemmesiden. Du skal bruge en API-nøgle fra din konto.
1. Lav en nøgle
Nøglerne laves fra din konto, kl Indstillinger, API-nøgler.
Nøglen vises kun én gang, ved oprettelse. Kopier det derefter og opbevar det sikkert; du kan ikke se det efter det.
2. Log ind
Send nøglen med hver anmodning i en af to overskrifter:
Authorization: Bearer seconda_ab12cd34_...
# sau, la fel de bine:
X-API-Key: seconda_ab12cd34_...3. Opret en annonce
Send annoncedata i JSON-format. Prisen er hel, i penge (15000 betyder 150,00 lei). Følgende er obligatoriske: titel (5-80 tegn), beskrivelse (20-3000 tegn), kategori (en kategori-bladsnegl) og 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"
}'Svaret indeholder annonce-id'et, som du skal bruge i de næste trin.
4. Upload billeder
Send billederne som en multipart, med "billeder"-feltet gentaget for hver fil. Mellem 1 og 20 billeder 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. Udgiv annoncen
Når du har tilføjet dine billeder, skal du offentliggøre din annonce for at blive vist i kataloget.
curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/publica \
-H "Authorization: Bearer CHEIA_TA"Bekræftelsesmails
Når du sender manuelt fra siden, får du en bekræftelses-e-mail for hver annonce. Når du poster gennem API'et, med en nøgle, får du ikke en e-mail med hver annonce, men en enkelt oversigt sidst på dagen.