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: marraskuuta 9, 2021

Tämä koskee seuraavia:

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: 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 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.

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

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