Siirry sisältöön
Huomaa: Tämän artikkelin käännös on tarkoitettu vain tiedoksi. Käännös on luotu automaattisesti käännösohjelmiston avulla, eikä sitä ole välttämättä tarkistettu. Näin ollen tämän artikkelin englanninkielistä versiota on pidettävä hallitsevana versiona, joka sisältää uusimmat tiedot. Voit tutustua siihen täällä.

Pääset käsiksi HubSpotin API-avaimeen

Päivitetty viimeksi: kesäkuuta 28, 2023

Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:

Kaikki tuotteet ja HubSpot-tilaukset

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.

  • Napsauta HubSpot-tililläsi settings 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ä.

show-API-key

  • 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ä:
  • Napsauta HubSpot-tililläsi settings asetukset-kuvaketta päänavigointipalkissa.
  • 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.

  • Napsauta HubSpot-tililläsi settings asetukset-kuvaketta päänavigointipalkissa.
  • Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
  • Napsauta Tarkastusloki-välilehteä.
  • api-audit-log

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.

  • Napsauta HubSpot-tililläsi settings 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.
call-log-api

Oliko tästä artikkelista apua?
Tätä lomaketta käytetään vain dokumentaation palautteeseen. Lue, miten saat apua HubSpotin kanssa.