Päivitetty viimeksi: tammikuuta 20, 2023
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-avaimet ovat poistuneet käytöstä, eikä niitä enää tueta. HubSpot API Keys -avaimien jatkuva käyttö on turvallisuusriski tilillesi ja tiedoillesi. Tämän poistovaiheen aikana HubSpot voi poistaa avaimesi käytöstä milloin tahansa.
Sinun tulisi sen sijaan tunnistautua käyttämällä yksityisen sovelluksen käyttöoikeuskoodia tai OAuthia. Lue lisäätästä muutoksesta ja siitä, miten voit siirtää API-avainintegraation kä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 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ä.
- Kun avain on näkyvissä, kopioi avain valitsemalla 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 vaivaa, se lisää turvallisuuden tasoa estämällä haitallisten sovellusten pääsyn HubSpot-tietoihin olemassa olevalla 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.
- 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 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-tilisi Asetukset-kuvaketta päänavigointipalkissa.
- Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
- Napsauta Tarkastusloki-välilehteä.
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 päänavigointipalkissa.
- Siirry vasemman sivupalkin valikossa kohtaan Integraatiot > API-avain.
- Näytä Puheluloki-välilehdellä kaikki toiminta viimeisten 7 päivän ajalta.
