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:
- Varmista, että olet siirtänyt kaikki vaikuttavat integraatiot, japoista sitten API-avain käytöstä.
- Jos haluat tarkistaa, onko tilin API-avainta käytetty viimeisten seitsemän päivän aikana, voittarkastella API-avaimen soittohistoriaa. Puheluloki ei näytä pyyntöjä, jotka on tehty avaimella yli seitsemän päivää sitten.
- Tilin asetustenConnected apps-sivulla lueteltuja sovelluksia ei tarvitse siirtää, koska ne todennetaan OAuthin avulla.
- Kehittäjien API-avaimet ovat erillisiä HubSpotin tavallisista API-avaimista, eikä niitä poisteta käytöstä. Kehittäjä-API-avaimia käytetään HubSpot-sovelluksiisi liittyvien asetusten hallintaan, mukaan lukienwebhooks API-tilaukset jaaikajanan tapahtumat API-tapahtumatyypit.
API-avaimen käyttäminen
Sinulla on oltava Super Admin -oikeudet, jotta voit käyttää tilisi API-avainta.
- Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta.
- 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ä:- Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta.
- 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-tilisi ylänavigointipalkin settings asetuskuvaketta.
- 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.
- Napsauta HubSpot-tilisi ylänavigointipalkin settings asetuskuvaketta.
- Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
- Näytä Puheluloki-välilehdellä kaikki toiminta viimeisten 7 päivän ajalta.