Desarrolladores

Usar claves API y Atajos

Conectar flujos de captura o transcripción repetitivos sin exponer secretos.

Audiencia
Desarrolladores y usuarios avanzados integrando Vowise en flujos de trabajo existentes.
Tiempo
18 minutos
Nivel
Avanzado

Escenario

Empieza por el flujo para el que esta guía fue diseñada antes de seguir los pasos.

Como constructor de automatización, quiero una forma repetitiva de enviar audio a Vowise para poder conectar herramientas de captura sin cargar archivos manualmente.

Sabes dónde encajan las claves API, cómo probar la referencia pública y qué reglas de manejo de secretos seguir.

Pasos

1

Crear o localizar una clave API

Usa la superficie de cuenta destinada a claves API. Trata la clave como un secreto, no como contenido tutorial público.

La clave se almacena fuera del repositorio.
Las capturas de pantalla enmascaran o omiten la clave.
2

Probar la referencia API pública

Usa `/api-reference` para entender la forma de solicitud de transcripción y diccionario pública antes de ponerla en automatización.

Sabes el formato del encabezado de autenticación.
Sabes qué puntos finales son públicos.
3

Construir el contenedor de automatización

Envuelve la solicitud en Atajos, un script local o un flujo de trabajo del lado del servidor que pueda mantener la clave privada.

El flujo de trabajo no imprime la clave en los registros.
Los fallos son visibles sin exponer credenciales.

Detalles

Reglas de manejo de secretos

La documentación puede enseñar la forma de solicitud, pero los ejemplos deben usar marcadores de posición en lugar de secretos reales, contraseles reutilizables o URL privadas.

  • Usa marcadores de posición en documentos y capturas de pantalla.
  • Mantén las claves reales en almacenes de secretos locales o configuración del lado del servidor.
  • Rota una clave si aparece en una grabación pública.

Rutas de funciones conectadas

Este tutorial no debería terminar aquí. Estas son las siguientes funciones y flujos naturales.