Ce este?

Noul Developer Secrets API (beta) permite agenților și automatizărilor personalizate să gestioneze complet secretele aplicației tale.

Un agent poate lista cheile secrete ale aplicației, poate crea secrete noi, poate actualiza valorile existente (de exemplu, pentru a înlocui o credențială care urmează să expire) și poate șterge secretele care nu mai sunt necesare.

De ce este important?

Configurarea și întreținerea secretelor de care depinde o aplicație, precum cheile API și tokenurile de acces, au reprezentat în mod tradițional pași manuali, efectuați prin HubSpot CLI sau instrumentele pentru dezvoltatori.

Cu Developer Secrets API, agenții pot gestiona aceste credențiale în locul tău.

Valorile secretelor sunt disponibile doar pentru scriere (write-only), ceea ce înseamnă că API-ul nu le returnează niciodată. Astfel, agenții pot crea, actualiza și șterge credențialele fără să poată citi vreodată valorile acestora.

Cum funcționează?

API-ul este limitat la aplicația ta și folosește contul HubSpot asociat tokenului de autentificare.

Fiecare cont poate avea până la 100 de secrete ale aplicațiilor, cumulat pentru toate aplicațiile sale.

Autorizează aplicația cu:

• developer.secrets.read pentru a lista cheile secrete.
• developer.secrets.write pentru a crea, actualiza sau șterge secrete.

Dacă agentul tău trebuie să verifice ce secrete lipsesc înainte de a crea unul nou, autorizează ambele scope-uri. Pentru a accesa endpoint-urile beta, folosește cheia API de dezvoltator pentru autentificare (documentația privind cheile API pentru dezvoltatori). 

Apoi apelează endpoint-urile disponibile la: /developers/secrets/2027-03-beta/apps/{appId}/secrets

• GET .../secrets: listează cheile secrete.
• POST .../secrets: creează un secret.
• POST .../secrets/update: actualizează valoarea unui secret.
• POST .../secrets/delete: șterge un secret.
•  
•  

Cine beneficiază?

Funcționalitatea este disponibilă în prezent în versiune beta pentru toate conturile HubSpot care au aplicații pentru dezvoltatori.