API pour les développeurs
Avec l'API Seconda, vous pouvez publier des annonces par programmation, sans ouvrir le site Web. Vous avez besoin d'une clé API de votre compte.
1. Créez une clé
Les clés se font depuis votre compte, à Paramètres, clés API.
La clé n'est affichée qu'une seule fois, lors de la création. Copiez-le ensuite et conservez-le en lieu sûr ; après ça, on ne le voit plus.
2. Connectez-vous
Envoyez la clé avec chaque requête, dans l'un des deux en-têtes :
Authorization: Bearer seconda_ab12cd34_...
# sau, la fel de bine:
X-API-Key: seconda_ab12cd34_...3. Créez une annonce
Envoyez les données publicitaires au format JSON. Le prix est entier, en argent (15 000 signifie 150,00 lei). Les éléments suivants sont obligatoires : le titre (5 à 80 caractères), la description (20 à 3 000 caractères), la catégorie (une limace de feuille de catégorie) et le prix (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"
}'La réponse contient l'identifiant de l'annonce dont vous avez besoin pour les étapes suivantes.
4. Téléchargez des photos
Envoyez les images en plusieurs parties, avec le champ « images » répété pour chaque fichier. Entre 1 et 20 images, au format JPEG, PNG ou WebP.
curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/poze \
-H "Authorization: Bearer CHEIA_TA" \
-F "[email protected]" \
-F "[email protected]"5. Publiez l'annonce
Après avoir ajouté vos photos, publiez votre annonce pour qu'elle apparaisse dans le catalogue.
curl -X POST https://seconda.ro/api/v1/articole/ID_ARTICOL/publica \
-H "Authorization: Bearer CHEIA_TA"E-mails de confirmation
Lorsque vous publiez manuellement, depuis le site, vous recevez un email de confirmation pour chaque annonce. Lorsque vous postez via l'API, avec une clé, vous ne recevez pas d'e-mail avec chaque annonce, mais un seul résumé en fin de journée.