HubSpot Tietämyskanta

Pääset käsiksi HubSpotin API-avaimeen

Kirjoittanut HubSpot Support | Nov 1, 2021 3:33:20 PM

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:30. marraskuuta 2022 alkaen HubSpot API Keys -avaimet poistuvat käytöstä, eikä niitä enää tueta. Sen sijaan sinun on tunnistauduttava käyttämällä yksityisen sovelluksen käyttöoikeustunnusta tai OAuthia. Lue lisäätästä muutoksesta ja siitä, miten voitsiirtää API-avainintegraation käyttämään sen sijaan yksityistä sovellusta.

Jos näet tililläsi bannerin API-avaimen deaktivoinnista:

API-avaimen käyttäminen

Sinulla on oltava Super Admin -oikeudet, jotta voit käyttää tilisi API-avainta.

  • 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 valitsemalla Kopioi. Voit sitten liittää avaimen ja antaa sen kehittäjille tai käyttää sitä sovelluksissasi.

API-avaimen kiertäminen

API-avaimen antaminen kehittäjälle antaa heille täydet oikeudet tehdä muutoksia tiliisi HubSpotin API:n kautta, mukaan lukien kirjautuneiden sähköpostien 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ä 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. 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.

Deaktivoitua 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ä:
  • Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
  • Napsauta pudotusvalikosta Toiminnot .
  • Valitse Deactivate key (Ota avain pois käytöstä ) ja valitse Deactivate 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.

  • Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
  • Napsauta Tarkastusloki-välilehteä.

Näytä API-avaimen kutsuloki

Jos haluat auttaa jonkin integraatiosi virheenkorjauksessa tai varmistaa, että noudatat HubSpotin API-käyttöohjeita, voit tarkastella lokia API-avaimen kutsuista edellisen 7 päivän ajalta.

  • Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
  • Näytä Puheluloki-välilehdellä kaikki toiminta viimeisten 7 päivän ajalta.