Ce este?

Poți utiliza acum un endpoint de API public care îți permite să dezinstalezi programatic clienți din aplicația ta. Acest API este acum disponibil general (GA).

Atunci când trimiți o cerere reușită către acest endpoint, vei primi un răspuns HTTP 204 No Content. Odată ce dezinstalarea este finalizată, HubSpot va trimite automat un email de notificare administratorilor contului clientului, informându-i că aplicația a fost eliminată din portalul lor.

API-ul necesită OAuth Access Token-ul existent al clientului pentru a autentifica cererea. Poți afla mai multe despre gestionarea și utilizarea OAuth în documentația noastră pentru dezvoltatori.

Emailul de notificare trimis administratorilor contului include și un link către pagina de conectare a aplicației. Acest lucru le permite să reinstaleze aplicația dacă dezinstalarea a fost neintenționată sau dacă decid să reconecteze integrarea ulterior.

De ce este important?

Mulți parteneri de aplicații au clienți care nu mai folosesc produsul, dar care încă au integrarea instalată în HubSpot. Acest lucru poate duce la apeluri API inutile între sisteme, creând ineficiențe și încărcare suplimentară.

Cu acest nou endpoint de API, poți elimina proactiv instalările inactive sau neutilizate direct din sistemele tale. Acest lucru te ajută să menții date de integrare mai curate, să reduci traficul API inutil și să te asiguri că utilizarea aplicației tale reflectă mai precis relațiile active cu clienții.

Cum funcționează?

Noul endpoint utilizează metoda DELETE. Documentația completă este disponibilă în referința endpoint-ului App Uninstall API.

Exemplu de cerere curl:

curl --location --request DELETE 'https://api.hubspot.com/appinstalls/v3/external-install' \

--header 'Authorization: Bearer :access token:'

Cine îl primește?

Acest API este disponibil pentru toate hub-urile și toate nivelurile de abonament.