Päivitetty viimeksi: kesäkuuta 23, 2022
HubSpotin API-avaimen avulla kehittäjänne 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:30. marraskuuta 2022 alkaen HubSpotin API-avaimia ei voi enää käyttää todennusmenetelmänä HubSpotin API-rajapintojen käyttämiseen. Lisäksi 15. heinäkuuta 2022 alkaen tilit, joilla ei ole jo luotua HubSpotin API-avainta, eivät voi enää luoda sellaista.
Sen sijaan sinun on käytettävä yksityisen sovelluksen käyttöoikeuskoodia tai OAuthia API-kutsujen todennukseen. Lue lisäätästä muutoksestaja siitä, miten voitsiirtää API-avainintegraationkäyttämään sen sijaan yksityistä sovellusta.
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.
Sähköposti-ilmoitukset lähetetään 180 päivän välein pääylläpitäjille ja käyttäjille, jotka ovat viimeksi luoneet tai pyörittäneet API-avaimen, jos API-avainta ei ole pyöritetty kyseisenä aikana.
Vaikka tämä saattaa aiheuttaa seisokkiaikaa ja vaatia vaivannäköä, se lisää turvallisuuden tasoa estämällä haitallisia sovelluksia pääsemästä käsiksi HubSpot-tietoihisi nykyisellä API-avaimellasi.
HubSpotin API-avaimen vaihtaminen:
- Napsauta HubSpot-tililläsi päänavigointipalkin Asetukset-kuvaketta.
- 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.
- Valitse 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
Jos haluat auttaa jonkin integraation virheenkorjauksessa tai varmistaa, että noudatat seuraavia sääntöjä HubSpotin API:n käyttöohjeet, voit tarkastella lokia API-avaimen puheluista viimeisten 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.
