Ταυτοποίηση Partner API: κλειδιά Bearer ec_live_, εναλλαγή και σφάλματα 401
Κάθε αίτημα Partner API μεταφέρει το μυστικό κλειδί του λογαριασμού στην κεφαλίδα Authorization: Bearer ec_live_…, που στέλνεται από τον server σας. Κάθε λογαριασμός του easyCoexistence έχει ένα κλειδί, που δημιουργείται στο dashboard, στην ενότητα Profile, Developers, ή ζητώντας από έναν βοηθό AI να εκτελέσει το create_api_key, και εμφανίζεται μόνο μία φορά. Η εναλλαγή εκδίδει νέο κλειδί και τερματίζει αμέσως το παλιό· ένα ελλιπές ή λανθασμένο κλειδί επιστρέφει 401 unauthorized.
Το πρόθεμα με το οποίο ξεκινά κάθε κλειδί Partner API, που στέλνεται σε κάθε αίτημα ως Authorization: Bearer.
Τα κλειδιά που μπορεί να έχει ταυτόχρονα ένας λογαριασμός· κάθε σύνδεση που γίνεται με αυτό ανήκει στον λογαριασμό.
Η κατάσταση για ελλιπές ή άκυρο κλειδί, με τον κωδικό σφάλματος unauthorized και μήνυμα που αναφέρει την αναμενόμενη κεφαλίδα.
Πόσες φορές εμφανίζεται το πλήρες κλειδί, όταν δημιουργείται ή αντικαθίσταται· έπειτα φαίνονται μόνο οι πρώτοι χαρακτήρες του.
Πώς ταυτοποιείται ένα αίτημα;
Με το κλειδί ως Bearer token στην κεφαλίδα Authorization κάθε αιτήματος προς https://easycoexistence.com/api/v1. Τίποτα άλλο δεν υπογράφεται ούτε περιορίζεται: το κλειδί ταυτοποιεί τον λογαριασμό, και ό,τι δημιουργεί ή διαβάζει ένα αίτημα ανήκει σε αυτόν. Τα σώματα των αιτημάτων είναι JSON, και κάθε σφάλμα επιστρέφεται ως αντικείμενο με κωδικό και μήνυμα.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Πού δημιουργείτε το κλειδί;
Στο dashboard ή από έναν βοηθό AI, με το ίδιο αποτέλεσμα. Στο dashboard ανοίξτε το Profile, μετά το Developers, και πατήστε Create API key. Στο Claude, στο ChatGPT ή σε άλλον βοηθό συνδεδεμένο με τον MCP server του easyCoexistence, ζητήστε να ρυθμίσει το Partner API: το get_partner_setup δείχνει τι λείπει και το create_api_key επιστρέφει το κλειδί. Και στις δύο περιπτώσεις το πλήρες κλειδί εμφανίζεται μία φορά, γι' αυτό αποθηκεύστε το αμέσως στο σημείο αποθήκευσης μυστικών του backend σας.
Γιατί το κλειδί εμφανίζεται μόνο μία φορά;
Επειδή αποθηκεύεται μόνο το hash του. Το easyCoexistence κρατά το hash για να ελέγχει κάθε αίτημα, και επιπλέον τους πρώτους χαρακτήρες του κλειδιού, το ec_live_ και άλλους έξι, ώστε το dashboard να δείχνει ποιο κλειδί ισχύει και πότε δημιουργήθηκε. Ένα χαμένο κλειδί δεν μπορεί να ξαναεμφανιστεί· η εναλλαγή δημιουργεί νέο.
Πώς αντικαθιστάτε ή ανακαλείτε το κλειδί;
Με ένα βήμα, και το παλιό κλειδί σταματά να λειτουργεί εκείνη τη στιγμή, χωρίς περίοδο χάριτος, αφού συνήθως ο λόγος για εναλλαγή είναι διαρροή. Το νέο κλειδί εμφανίζεται μία φορά, όπως και το πρώτο:
- Dashboard: Profile, Developers, Rotate key.
- MCP:
create_api_keyμε τοreplace_existingίσο με true. Χωρίς αυτό, το εργαλείο αρνείται όσο υπάρχει κλειδί, ώστε μια ενσωμάτωση που τρέχει να μη σπάσει κατά λάθος. - Για να σταματήσετε κάθε πρόσβαση, ανακαλέστε: Revoke στο dashboard ή
revoke_api_keyμε confirm ίσο με true. Τα αιτήματα τότε αποτυγχάνουν έως ότου δημιουργηθεί νέο κλειδί.
Τι επιστρέφει ένα ελλιπές ή λανθασμένο κλειδί;
Σφάλμα 401 με τον κωδικό unauthorized, για αίτημα χωρίς κεφαλίδα Authorization, για κλειδί που δεν ξεκινά με ec_live_, ή για κλειδί που αντικαταστάθηκε ή ανακλήθηκε. Το μήνυμα αναφέρει την κεφαλίδα που αναμένεται. Όταν τα αποτυχημένα αιτήματα έρχονται συνεχώς από μία διεύθυνση, το API απαντά 429 rate_limited, με τα δευτερόλεπτα αναμονής πριν από νέα προσπάθεια.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Τι άλλο μπορεί να απορρίψει ένα έγκυρο κλειδί;
Ένα έγκυρο κλειδί ταυτοποιεί τον λογαριασμό, και η κατάσταση του λογαριασμού εξακολουθεί να ισχύει. Αυτά επιστρέφουν με το ίδιο σχήμα σφάλματος:
- 402
billing_required: δεν υπάρχει ακόμη κάρτα στον λογαριασμό, οπότε δεν μπορεί να ξεκινήσει συνεδρίες σύνδεσης. - 404
not_found: το id δεν ανήκει σε καμία σύνδεση, κανάλι ή συνεδρία αυτού του λογαριασμού, συμπεριλαμβανομένων εκείνων σε άλλους λογαριασμούς. - 409 removed: η σύνδεση αφαιρέθηκε, οπότε το webhook της δεν μπορεί να αλλάξει.
- 402 suspended: η σύνδεση είναι σε αναστολή μετά από ληγμένη συνδρομή· επανασυνδέστε την πρώτα.
- 429
cap_reachedήrate_limited: πάρα πολλές ανοιχτές συνεδρίες σύνδεσης, ή πάρα πολλές δημιουργημένες μέσα στην τρέχουσα ώρα.
Συνηθισμένα λάθη
- Τοποθέτηση του κλειδιού στον κώδικα front-end. Όποιος ανοίγει τη σελίδα μπορεί να το διαβάσει, να δημιουργήσει συνδέσεις που χρεώνονται σε εσάς και να ανακτήσει τα tokens των πελατών σας με ?credentials=1.
- Εναλλαγή του κλειδιού πριν το backend σας μπορεί να δεχτεί το νέο. Το παλιό σταματά αμέσως, οπότε κάθε αίτημα αποτυγχάνει με 401 μέχρι να αναπτυχθεί το νέο.
- Δημιουργία του κλειδιού σε συζήτηση που μοιράζεστε. Το create_api_key το επιστρέφει στο chat, όπου μένει στο ιστορικό, οπότε εναλλάξτε το αν η συζήτηση μοιραστεί.
- Αποθήκευση του κλειδιού με εισαγωγικά γύρω του. Ό,τι ακολουθεί το Bearer διαβάζεται ως κλειδί, οπότε μια τιμή με εισαγωγικά δεν ταιριάζει ποτέ και κάθε αίτημα παίρνει 401.
Το easyCoexistence δίνει σε κάθε λογαριασμό ένα κλειδί Partner API, ώστε το backend σας να συνδέει τους αριθμούς WhatsApp των πελατών σας και τους λογαριασμούς τους στο Instagram, Facebook, TikTok, YouTube και LinkedIn, καθώς και άλλα κανάλια, και στη συνέχεια να διαβάζει τα διαπιστευτήρια κάθε σύνδεσης και να δρομολογεί τα γεγονότα της. Από US$ 9 έως US$ 0,75 ανά σύνδεση τον μήνα, με μείωση όσο προσθέτετε συνδέσεις, και με δωρεάν δοκιμή 3 ημερών.
Συχνές ερωτήσεις
Μπορεί ένας λογαριασμός να έχει περισσότερα από ένα κλειδί Partner API;
Όχι. Ένας λογαριασμός έχει ένα κλειδί κάθε στιγμή, και η δημιουργία νέου αντικαθιστά το προηγούμενο. Χωριστά κλειδιά σημαίνουν χωριστούς λογαριασμούς του easyCoexistence, καθένας με τις δικές του συνδέσεις και τη δική του χρέωση.
Λήγουν τα κλειδιά Partner API;
Όχι. Ένα κλειδί ισχύει έως ότου αντικατασταθεί ή ανακληθεί, ή έως ότου το easyCoexistence το τερματίσει λόγω κατάχρησης των κανόνων της Meta.
Χρειάζονται οι πελάτες μου το κλειδί μου για να συνδεθούν;
Όχι. Ανοίγουν μόνο τον φιλοξενούμενο σύνδεσμο σύνδεσης, που φέρει δικό του id συνεδρίας. Το κλειδί μένει στον server σας και το χρησιμοποιεί μόνο το backend σας.
Είναι το κλειδί Partner API το ίδιο με το μυστικό υπογραφής των γεγονότων;
Όχι. Το κλειδί ταυτοποιεί τα αιτήματά σας προς το API. Το μυστικό υπογραφής, που εμφανίζεται μία φορά όταν ορίζετε URL γεγονότων κατάστασης, επιτρέπει στο endpoint σας να επαληθεύει τα γεγονότα που στέλνει το easyCoexistence.
Συνεχίστε την ανάγνωση
Συνδέστε το πρώτο σας κανάλι σε δύο λεπτά.
Χωρίς αναμονή για έλεγχο από τις πλατφόρμες. Συνδέστε WhatsApp, Instagram, TikTok ή άλλο κανάλι, ζητήστε από το AI σας να δημοσιεύσει, να απαντήσει ή να δημιουργήσει αναφορά και δείτε το να δουλεύει.
- 3 ημέρες δωρεάν
- Ακύρωση ανά πάσα στιγμή
- Μόνο επίσημα API
- Παρακολούθηση 24/7
Επαληθεύτηκε στις