Μετάβαση στο περιεχόμενο

SMSBAT ChatHub API

Το ChatHub REST API διαχειρίζεται επαγγελματικές συνομιλίες Viber, συνομιλίες πελατών και ροές εργασίας αυτοματισμού υποστήριξης πελατών.

Βασική διεύθυνση URL

https://chatapi.smsbat.com

Τεκμηρίωση Swagger

Η διαδραστική τεκμηρίωση API είναι διαθέσιμη στη διεύθυνση:

https://chatapi.smsbat.com/index.html

Έλεγχος ταυτότητας

Το ChatHub χρησιμοποιεί ένα σύστημα ελέγχου ταυτότητας που βασίζεται σε διακριτικά Bearer με μάρκες JWT. Τα διακριτικά μπορούν να περάσουν με δύο τρόπους:

Μέθοδος 1: Κεφαλίδα εξουσιοδότησης

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "Authorization: Bearer your-jwt-token"

Μέθοδος 2: X-Authorization-Key Header

curl -X GET https://chatapi.smsbat.com/api/company/organization \
  -H "X-Authorization-Key: your-jwt-token"

Ροή ελέγχου ταυτότητας

Το ChatHub χρησιμοποιεί ένα σύστημα διακριτικών δύο επιπέδων:

  1. Company Token - Token πρόσβασης σε επίπεδο οργανισμού
  2. Operator Token - Μεμονωμένο διακριτικό πρόσβασης χειριστή

Ροή εργασιών

graph LR
    A[Get Company Token] --> B[List Organizations]
    B --> C[List/Add Operators]
    C --> D[Get Operator Token]
    D --> E[Integrate Widget]

Κύρια τελικά σημεία

Μέθοδος Τελικό σημείο Περιγραφή
ΑΝΑΡΤΗΣΗ /api/company/get-token Λάβετε διακριτικό εξουσιοδότησης εταιρείας
ΠΑΡΕ «/api/εταιρεία/οργανισμός» Ανάκτηση λίστας οργανισμών
ΠΑΡΕ /api/operator Κατάλογος χειριστών ανά οργανισμό
ΑΝΑΡΤΗΣΗ /api/operator/synchronize Προσθήκη νέων χειριστών
ΑΝΑΡΤΗΣΗ «/api/operator/status» Αλλαγή κατάστασης χειριστή
ΑΝΑΡΤΗΣΗ /api/operator/get-token Δημιουργία κουπονιών χειριστή (μέγιστη λήξη 24 ωρών)
ΑΝΑΡΤΗΣΗ /api/operator/validate-token Επαλήθευση εγκυρότητας διακριτικού

Βασικά χαρακτηριστικά

Διαχείριση διακριτικών της εταιρείας

Αποκτήστε και διαχειριστείτε διακριτικά σε επίπεδο οργανισμού για πρόσβαση στο API.

Διοίκηση Οργανισμού

  • Καταγράψτε όλους τους οργανισμούς
  • Ανάκτηση στοιχείων οργάνωσης
  • Διαχειριστείτε τις ρυθμίσεις του οργανισμού

Διαχείριση χειριστή

  • Κατάλογος χειριστών ανά οργανισμό
  • Προσθήκη νέων τελεστών
  • Αλλαγή κατάστασης χειριστή (Ενεργός/Ανενεργός/Διαγραμμένος)
  • Δημιουργήστε διακριτικά ειδικά για χειριστή (μέγιστο 24 ώρες)
  • Επικύρωση διακριτικών χειριστή

Ενσωμάτωση γραφικών στοιχείων

Ενσωματώστε το γραφικό στοιχείο ChatHub σε εφαρμογές web για υποστήριξη πελατών σε πραγματικό χρόνο.

Γρήγορη εκκίνηση

  1. Έλεγχος ταυτότητας - Λάβετε τα διακριτικά της εταιρείας και του χειριστή σας
  2. Οργανισμοί - Διαχείριση οργανισμών
  3. Χειριστές - Προσθήκη και διαχείριση τελεστών
  4. Ενσωμάτωση γραφικών στοιχείων - Ενσωμάτωση γραφικού στοιχείου συνομιλίας

Μορφή αιτήματος

Όλα τα αιτήματα χρησιμοποιούν μορφή JSON:

{
  "login": "your-login",
  "password": "your-password"
}

Μορφή απόκρισης

Επιστροφή επιτυχών απαντήσεων:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "expiration": "2025-01-24T12:00:00Z"
}

Χειρισμός σφαλμάτων

Κωδικοί κατάστασης HTTP:

  • 200 OK - Το αίτημα επιτυχής
  • 400 Bad Request - Μη έγκυρη μορφή αιτήματος
  • 401 Μη εξουσιοδοτημένο - Ο έλεγχος ταυτότητας απέτυχε
  • 403 Απαγορευμένο - Ανεπαρκή δικαιώματα
  • 404 Δεν βρέθηκε - Ο πόρος δεν βρέθηκε
  • 500 Εσωτερικό Σφάλμα διακομιστή - Σφάλμα διακομιστή

Λήξη διακριτικού

Τα token έχουν χρόνο λήξης. Όταν λήξει ένα διακριτικό:

  1. Το API θα επιστρέψει το "401 Unauthorized".
  2. Ζητήστε ένα νέο διακριτικό χρησιμοποιώντας το τελικό σημείο ελέγχου ταυτότητας
  3. Ενημερώστε την αίτησή σας με το νέο διακριτικό

Επόμενα βήματα