Pääset käsiksi HubSpotin API-avaimeen

HubSpotin API-avaimen avulla kehittäjänne voivat luoda mukautettuja sovelluksia HubSpotin API:iden

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

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

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

Huomaa: API-avaimen vaihtaminen ei vaikuta App Marketplacen

API-avaimen poistaminen käytöstä

API-avaimen deaktivointi ei

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

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.