Desenvolvedores

Usar chaves de API e Atalhos

Conectar fluxos de captura ou transcrição repetíveis sem expor segredos.

Público
Desenvolvedores e usuários avançados integrando o Vowise em fluxos de trabalho existentes.
Tempo
18 minutos
Nível
Avançado

Cenário

Comece pelo fluxo para o qual este guia foi criado antes de seguir os passos.

Como construtor de automação, quero um método repetitivo para enviar áudio para o Vowise para poder conectar ferramentas de captura sem fazer upload manual de arquivos.

Você sabe onde as chaves de API se encaixam, como testar a referência pública e quais regras de manipulação de segredos seguir.

Passos

1

Criar ou localizar uma chave de API

Use a superfície de conta destinada a chaves de API. Trate a chave como um segredo, não como conteúdo de tutorial público.

A chave é armazenada fora do repositório.
As capturas de tela ocultam ou omitem a chave.
2

Testar a referência da API pública

Use `/api-reference` para entender o formato de solicitação de transcrição e dicionário público antes de colocá-lo em automação.

Você conhece o formato do cabeçalho de autenticação.
Você sabe quais endpoints são públicos.
3

Construir o wrapper de automação

Envolva a solicitação em Atalhos, um script local ou um fluxo de trabalho do lado do servidor que pode manter a chave privada.

O fluxo de trabalho não imprime a chave nos logs.
Falhas são visíveis sem expor credenciais.

Detalhes

Regras de manipulação de segredos

A documentação pode ensinar o formato da solicitação, mas os exemplos devem usar espaços reservados em vez de segredos reais, senhas reutilizáveis ou URLs privadas.

  • Use espaços reservados na documentação e capturas de tela.
  • Mantenha chaves reais em armazenamentos de segredos locais ou configurações do lado do servidor.
  • Roteie uma chave se ela aparecer em uma gravação pública.

Caminhos de recursos conectados

Este tutorial não deve terminar aqui. Estes são os próximos recursos e fluxos naturais.