Päivitetty viimeksi: marraskuuta 9, 2021
HubSpotin API-avaimen avulla kehittäjät voivat luoda mukautettuja sovelluksia HubSpotin API:iden
avulla. Kukin avain koskee HubSpot-tiliä, ei yksittäistä käyttäjää, ja vain yksi avain on sallittu kerrallaan.Huomaa: jos aiot luoda useita sovelluksia tai haluat tarkempaa hallintaa sovelluksesi laajuuksista, voit luoda yksityisen sovelluksen sen sijaan, että käyttäisit yhtä API-avainta kaikissa sovelluksissasi. Jokaisella yksityisellä sovelluksella on oma käyttöoikeustunnuksensa, joka on toteutettu OAuthin päälle. Lue lisää yksityisistä sovelluksista HubSpotin kehittäjädokumentaatiosta
.API-avaimen käyttäminen
Sinulla on oltava Super Admin -oikeudet
, jotta voit käyttää tilisi API-avainta.- Napsauta HubSpot-tilisi Asetukset-kuvaketta päänavigointipalkissa.
- Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
- Jos tilillesi ei ole koskaan luotu avainta, valitse Generate API key.
- Jos olet jo luonut API-avaimen, näytä avaimesi valitsemalla Näytä.
- Kun avain on näkyvissä, kopioi avain napsauttamalla Kopioi. Voit sitten liittää avaimen ja antaa sen kehittäjille tai käyttää sitä sovelluksissasi.
Kierrä API-avaimesi
API-avaimen antaminen kehittäjälle antaa hänelle täydet oikeudet tehdä muutoksia tiliisi HubSpotin API:n kautta, mukaan lukien kirjautuneiden sähköpostiviestien lukeminen liitetyiltä sähköpostitileiltä ja muiden kolmansien osapuolten tietojen lukeminen.
Lisäturvallisuuden vuoksi kannattaa harkita HubSpotin API-avaimen vaihtamista kuuden kuukauden välein. HubSpotin API-avaimen vaihtaminen deaktivoi nykyisen API-avaimen ja luo uuden. HubSpot näyttää API-avaimen iän ja suosittelee, milloin API-avain kannattaa vaihtaa.
Muistutukset API-avaimen uusimisesta lähetetään Super Adminille ja käyttäjille, jotka ovat viimeksi luoneet tai uusineet API-avaimen, seuraavin väliajoin ja ilmoitustyypein:
- Kun API-avain vanhenee viisi kuukautta, lähetetään sähköposti-ilmoitukset.
- Kun API-avain on kuusi kuukautta vanha, lähetetään sivupalkki-ilmoitukset.
- Kun API-avainta ei ole vaihdettu kuuteen kuukauteen, sekä sähköposti- että sivupalkki-ilmoitukset lähetetään kuuden kuukauden välein.
Vaikka tämä voi aiheuttaa seisokkiaikaa ja vaatia vaivaa, se lisää turvallisuuden tasoa estämällä haitallisten sovellusten pääsyn HubSpot-tietoihisi nykyisellä API-avaimellasi.
HubSpotin API-avaimen vaihtaminen:
- Napsauta HubSpot-tililläsi päänavigointipalkin asetuskuvaketta.
- Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
- Napsauta pudotusvalikkoa Toiminnot ja valitse sitten Kierrä avain.
- Napsauta Rotate and expire this key now (Kierrä ja vanhenna tämä avain nyt). Valitse reCAPTCHA-valintaruutu. Nykyinen avaimesi poistetaan käytöstä ja uusi API-avain luodaan.
- Napsauta Kopioi ja korvaa sovellusten käyttämä deaktivoitu API-avain tällä uudella API-avaimella.
Poistettua HubSpotin API-avainta käyttävät API-kutsut epäonnistuvat nyt, eivätkä avainta käyttävät sovellukset voi enää käyttää tietojasi.
API-avaimen vaihtaminen ei vaikuta yhteyteen Salesforce-integraation
kanssa. Jos olet kuitenkin asentanut mukautetun integraation, sinun on päivitettävä API-avaimesi sen pyörittämisen jälkeen.Huomaa: API-avaimen vaihtaminen ei vaikuta App Marketplacen
kautta asennettuihin liitettyihin sovelluksiin.API-avaimen poistaminen käytöstä
API-avaimen deaktivointi ei
luo uutta avainta. Deaktivoitua HubSpotin API-avainta käyttävät API-kutsut epäonnistuvat, eivätkä avainta käyttävät sovellukset voi enää käyttää tietojasi. API-avaimen poistaminen käytöstä:- Napsauta HubSpot-tilisi Asetukset-kuvaketta päänavigointipalkissa.
- Siirry vasemman sivupalkin valikossa kohtaanIntegraatiot>API-avain.
- Napsauta pudotusvalikostaToiminnot.
- ValitseDeactivate key (Ota avain pois käytöstä ) ja valitseDeactivate this key now (Ota tämä avain pois käytöstä nyt). Valitse reCAPTCHA-valintaruutu.
Tarkastele API-auditointilokia
Voit tarkastella päivättyä lokia käyttäjistä, jotka ovat katsoneet, luoneet tai deaktivoineet tilisi API-avaimen, Audit-loki -osiossa.
- Napsauta HubSpot-tilisi Asetukset-kuvaketta päänavigointipalkissa.
- Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
- Napsauta Tarkastusloki-välilehteä.
Näytä API-avaimen kutsuloki
Auttaa sinua debuggaamaan jotakin integraatiotasi tai varmistaa, että noudatat seuraavia sääntöjä. HubSpotin API:n käyttöohjeetvoit tarkastella API-avainpyyntöjen lokia edellisen 7 päivän ajalta.
- Napsauta HubSpot-tilisi Asetukset-kuvaketta päänavigointipalkissa.
- Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
- Näytä Puheluloki-välilehdellä kaikki toiminta viimeisten 7 päivän ajalta.
