Partner API -todennus: Bearer ec_live_ -avaimet, vaihto ja 401-virheet
Jokainen Partner API -pyyntö kuljettaa tilin salaisen avaimen Authorization-otsakkeessa muodossa Bearer ec_live_…, ja pyyntö lähetetään palvelimeltasi. Jokaisella easyCoexistence-tilillä on yksi avain, joka luodaan hallintapaneelissa kohdassa Profile, Developers tai pyytämällä AI-avustajaa ajamaan create_api_key-työkalun, ja se näytetään vain kerran. Avaimen vaihto antaa uuden avaimen ja lopettaa vanhan heti. Puuttuva tai väärä avain saa vastaukseksi 401 unauthorized.
Etuliite, jolla jokainen Partner API -avain alkaa. Lähetetään jokaisessa pyynnössä Authorization: Bearer -muodossa.
Avainten määrä, jonka tili pitää kerrallaan. Jokainen avaimella tehty yhteys kuuluu tilille.
Tila puuttuvalle tai virheelliselle avaimelle, virhekoodi unauthorized ja viesti, joka nimeää odotetun otsakkeen.
Hetki, jolloin koko avain näytetään: luonnin tai vaihdon yhteydessä. Sen jälkeen näkyvissä on vain alku.
Miten pyyntö todennetaan?
Avaimella Bearer-tokenina Authorization-otsakkeessa jokaisessa pyynnössä osoitteeseen https://easycoexistence.com/api/v1. Muuta ei allekirjoiteta eikä rajata: avain tunnistaa tilin, ja kaikki pyynnön luoma tai lukema kuuluu tilille. Runko on JSON, ja jokainen virhe palautetaan oliona, jossa on code ja message.
curl https://easycoexistence.com/api/v1/connections \
-H "Authorization: Bearer $EC_API_KEY"Mistä avain luodaan?
Hallintapaneelista tai AI-avustajalta, samalla tuloksella. Hallintapaneelissa avaa Profile, sitten Developers ja paina Create API key. Claudessa, ChatGPT-palvelussa tai muussa easyCoexistencen MCP-palvelimeen yhdistetyssä avustajassa pyydä sitä määrittämään Partner API: get_partner_setup näyttää, mikä puuttuu, ja create_api_key palauttaa avaimen. Kummassakin tapauksessa koko avain näkyy kerran, joten tallenna se heti backendisi salaisuuksiin.
Miksi avain näytetään vain kerran?
Koska tallennetaan vain sen tiiviste. easyCoexistence säilyttää tiivisteen jokaisen pyynnön tarkistamiseen sekä avaimen ensimmäiset merkit, ec_live_ ja kuusi muuta, jotta hallintapaneeli voi näyttää, mikä avain on käytössä ja milloin se luotiin. Kadonnutta avainta ei voi näyttää uudelleen; vaihto korvaa sen.
Miten avain vaihdetaan tai mitätöidään?
Yhdellä askeleella, ja vanha avain lakkaa toimimasta sillä hetkellä ilman siirtoaikaa, koska vuoto on tavallisin syy vaihtaa. Uusi avain näytetään kerran, kuten ensimmäinen:
- Hallintapaneeli: Profile, Developers, Rotate key.
- MCP:
create_api_key, jonkareplace_existingon true. Ilman sitä työkalu kieltäytyy, kun avain on olemassa, joten käynnissä oleva integraatio ei katkea vahingossa. - Kaiken pääsyn lopettamiseksi mitätöi: Revoke hallintapaneelissa tai
revoke_api_key, jonka confirm on true. Pyynnöt epäonnistuvat sen jälkeen, kunnes uusi avain luodaan.
Mitä palautuu puuttuvasta tai väärästä avaimesta?
401 koodilla unauthorized, kun pyynnössä ei ole Authorization-otsaketta, avain ei ala etuliitteellä ec_live_ tai avain on vaihdettu tai mitätöity. Viesti nimeää odotetun otsakkeen. Jos epäonnistuneita pyyntöjä tulee yhdestä osoitteesta jatkuvasti, API vastaa sen sijaan 429 rate_limited ja kertoo sekunnit, jotka odotetaan ennen uutta yritystä.
{
"error": {
"code": "unauthorized",
"message": "Missing or invalid API key. Send `Authorization: Bearer ec_live_...`."
}
}Mitä muuta voimassa oleva avain voi estää?
Voimassa oleva avain tunnistaa tilin, ja tilin tila on yhä voimassa. Nämä palautuvat samalla virhemuodolla:
- 402
billing_required: tilillä ei ole vielä korttia, joten yhteysistuntoja ei voi aloittaa. - 404
not_found: tunnus ei kuulu tämän tilin yhteyteen, kanavaan eikä istuntoon, eikä myöskään muiden tilien vastaaviin. - 409 removed: yhteys on poistettu, joten sen webhookia ei voi muuttaa.
- 402 suspended: yhteys on keskeytetty tilauksen päätyttyä; yhdistä se uudelleen ensin.
- 429
cap_reachedtairate_limited: liian monta avointa yhteysistuntoa tai liian monta luotua tunnin aikana.
Yleiset virheet
- Avaimen laittaminen front-end-koodiin. Kuka tahansa, joka avaa sivun, voi lukea sen, luoda sinulle laskutettavia yhteyksiä ja hakea asiakkaidesi tokenit parametrilla ?credentials=1.
- Vaihto ennen kuin backendisi ottaa uuden avaimen vastaan. Vanha avain lakkaa heti, joten jokainen pyyntö epäonnistuu 401-virheellä, kunnes uusi on otettu käyttöön.
- Avaimen luominen jaetussa keskustelussa. create_api_key palauttaa avaimen chattiin, jossa se jää historiaan, joten vaihda se, jos keskustelu on jaettu.
- Avaimen tallentaminen lainausmerkkien sisään. Kaikki Bearer-sanan jälkeen luetaan avaimeksi, joten lainattu arvo ei koskaan täsmää ja jokainen pyyntö saa 401-virheen.
easyCoexistence antaa jokaiselle tilille yhden Partner API -avaimen, jolla backendisi voi yhdistää asiakkaidesi WhatsApp-numerot sekä Instagram-, Facebook-, TikTok-, YouTube- ja LinkedIn-tilit ja muita kanavia. Se lukee jokaisen yhteyden tunnistetiedot ja ohjaa sen tapahtumat eteenpäin. Hinta on US$ 9:stä US$ 0,75:een per yhteys kuukaudessa ja laskee yhteyksien määrän kasvaessa. Ensimmäiset 3 päivää ovat ilmaisia.
Usein kysytyt kysymykset
Voiko tilillä olla useampi Partner API -avain?
Ei. Tilillä on kerrallaan yksi avain, ja uuden luominen korvaa sen. Erilliset avaimet tarkoittavat erillisiä easyCoexistence-tilejä, joilla on omat yhteydet ja oma lasku.
Vanheneeko Partner API -avain?
Ei. Avain toimii, kunnes se vaihdetaan tai mitätöidään, tai kunnes easyCoexistence lopettaa sen Metan sääntöjen väärinkäytön vuoksi.
Tarvitsevatko asiakkaani avaintani yhdistääkseen?
Eivät. He avaavat vain isännöidyn yhdistämislinkin, jolla on oma istuntotunnus. Avain pysyy palvelimellasi, ja vain backendisi käyttää sitä.
Onko API-avain sama kuin tapahtumien allekirjoitussalaisuus?
Ei. Avain todentaa pyyntösi rajapintaan. Allekirjoitussalaisuus, joka näytetään kerran, kun asetat tilan tapahtumien URL-osoitteen, antaa päätepisteesi tarkistaa easyCoexistencen lähettämät tapahtumat.
Lue lisää
Yhdistä ensimmäinen kanavasi kahdessa minuutissa.
Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.
- 3 päivää ilmaiseksi
- Peruuta milloin tahansa
- Vain viralliset API:t
- Valvottu 24/7
Vahvistettu