API για προγραμματιστές

Με το Seconda API μπορείτε να δημοσιεύσετε διαφημίσεις μέσω προγραμματισμού, χωρίς να ανοίξετε τον ιστότοπο. Χρειάζεστε ένα κλειδί API από τον λογαριασμό σας.

1. Φτιάξτε ένα κλειδί

Τα κλειδιά γίνονται από τον λογαριασμό σας, στη διεύθυνση Ρυθμίσεις, πλήκτρα API.

Το κλειδί εμφανίζεται μόνο μία φορά, κατά τη δημιουργία. Αντιγράψτε το στη συνέχεια και κρατήστε το ασφαλές. δεν μπορείτε να το δείτε μετά από αυτό.

2. Συνδεθείτε

Στείλτε το κλειδί με κάθε αίτημα, σε μία από τις δύο κεφαλίδες:

Authorization: Bearer seconda_ab12cd34_...

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

3. Δημιουργήστε μια διαφήμιση

Αποστολή δεδομένων διαφήμισης σε μορφή JSON. Η τιμή είναι ολόκληρη, σε χρήματα (15000 σημαίνει 150,00 λέι). Τα ακόλουθα είναι υποχρεωτικά: τίτλος (5-80 χαρακτήρες), περιγραφή (20-3000 χαρακτήρες), κατηγορία (κατηγορία-φύλλων γυμνοσάλιαγκας) και τιμή (1-100.000 λέι).

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"
  }'

Η απάντηση περιέχει το αναγνωριστικό διαφήμισης, το οποίο χρειάζεστε στα επόμενα βήματα.

4. Ανεβάστε φωτογραφίες

Στείλτε τις εικόνες ως πολυμερή, με το πεδίο "εικόνες" να επαναλαμβάνεται για κάθε αρχείο. Μεταξύ 1 και 20 εικόνων, σε μορφή JPEG, PNG ή 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. Δημοσιεύστε την αγγελία

Αφού προσθέσετε τις φωτογραφίες σας, δημοσιεύστε τη διαφήμισή σας για να εμφανιστεί στον κατάλογο.

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

Email επιβεβαίωσης

Όταν δημοσιεύετε μη αυτόματα, από τον ιστότοπο, λαμβάνετε ένα μήνυμα ηλεκτρονικού ταχυδρομείου επιβεβαίωσης για κάθε διαφήμιση. Όταν δημοσιεύετε μέσω του API, με ένα κλειδί, δεν λαμβάνετε ένα μήνυμα ηλεκτρονικού ταχυδρομείου με κάθε διαφήμιση, αλλά μια μεμονωμένη περίληψη στο τέλος της ημέρας.

Cookies ανά δευτερόλεπτο