API fejlesztőknek
A Seconda API-val programozottan, a webhely megnyitása nélkül tehet közzé hirdetéseket. Szüksége van egy API-kulcsra a fiókjából.
1. Készítsen kulcsot
A kulcsok az Ön fiókjából készülnek, a címen Beállítások, API kulcsok.
A kulcs csak egyszer jelenik meg, a létrehozáskor. Ezután másolja ki, és őrizze meg; utána nem láthatod.
2. Jelentkezzen be
Küldje el a kulcsot minden kéréssel, a két fejléc egyikében:
Authorization: Bearer seconda_ab12cd34_...
# sau, la fel de bine:
X-API-Key: seconda_ab12cd34_...3. Hozzon létre egy hirdetést
Küldje el a hirdetési adatokat JSON formátumban. Az ár egészben, pénzben értendő (15000 150,00 lejt jelent). Kötelező a cím (5-80 karakter), a leírás (20-3000 karakter), a kategória (egy kategória-levél) és az ár (1-100 000 lej).
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"]
}'Közzétételkor a szállítási mező is kötelező: „moduriLivrare”, legalább az egyikkel a „personal” (személyes átadás) és a „curier” (futár vagy posta) közül; futárnál a „tariLivrare” is, azoknak az uniós országoknak a kódjai, ahová küldesz (például „RO”, „BG”). Nélküle a közzététel 400 ANUNT_INVALID választ ad, az „eroare.detalii” listában pedig a LIVRARE_LIPSA („moduriLivrare” mező) vagy a TARI_LIVRARE_LIPSA („tariLivrare” mező) hiba áll.
A válasz tartalmazza a hirdetésazonosítót, amelyre a következő lépésekben szüksége lesz.
4. Tölts fel képeket
Küldje el a képeket többrészesként, a "képek" mező megismétlésével minden fájlnál. 1-20 kép, JPEG, PNG vagy WebP formátumban.
curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/poze \
-H "Authorization: Bearer CHEIA_TA" \
-F "[email protected]" \
-F "[email protected]"5. A hirdetés közzététele
A fényképek hozzáadása után tegye közzé hirdetését, hogy megjelenjen a katalógusban.
curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/publica \
-H "Authorization: Bearer CHEIA_TA"Megerősítő e-mailek
Ha manuálisan, az oldalról tesz közzé, minden hirdetéshez kap egy megerősítő e-mailt. Amikor az API-n keresztül tesz közzé egy kulccsal, nem kap e-mailt minden hirdetéshez, hanem egyetlen összefoglalót a nap végén.