O que é?
As APIs de arquivos públicos da HubSpot foram atualizadas para seguir nossos novos padrões de API v3.
Por que isso Importa?
À medida que avançamos para nos tornarmos o ecossistema aberto e próspero que desejamos ser, a usabilidade da API deve fazer parte do plano. Ao longo dos anos, construÃmos muitas coisas realmente excelentes e enviamos muitas APIs valiosas, mas este é o ano em que, como empresa e como equipes de produto, aprimoramos nossas APIs juntas.
Com o lançamento da API Files v3, estamos um passo mais perto de tornar essa visão uma realidade.
Como funciona?
Os desenvolvedores podem visualizar o conjunto completo de novos documentos de API para v3 aqui.
Essas APIs seguem os novos padrões de design da HubSpot e devem funcionar como o resto de nossas APIs atualizadas.
A API v3 tem algumas diferenças da API mais antiga:
- Os endpoints que criam ou substituem arquivos exigem que você forneça um nÃvel de acesso para o arquivo, pois os arquivos não serão mais acessados ​​publicamente por padrão.
- Os pontos de extremidade que criam arquivos permitirão que você verifique se há arquivos duplicados durante o upload.
- Arquivos ocultos não podem mais ser criados, portanto, quaisquer arquivos criados usando a API ficarão visÃveis para os usuários em suas ferramentas de arquivo HubSpot.
- Os arquivos ocultos não serão retornados ao listar os arquivos, e o novo escopo files_ui_hidden.read será necessário para visualizar os detalhes dos arquivos ocultos quando recuperados por seu ID.
- Todos os terminais que executam uma ação em uma pasta são processados ​​de forma assÃncrona. Esses pontos de extremidade retornarão um token que pode ser usado para verificar o status do trabalho de atualização.
DisponÃvel para:
Esta API agora está disponÃvel para todos os desenvolvedores no HubSpot. Por favor, assine nosso changelog para atualizações futuras.