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ä.
Integrations

Pääset käsiksi HubSpotin API-avaimeen

Päivitetty viimeksi: kesäkuuta 23, 2022

Tämä koskee seuraavia:

Kaikki tuotteet ja HubSpot-tilaukset

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 settings 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 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 settings 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 settings 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 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 settings 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

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.