Développeurs

Utiliser les clés API et les Raccourcis

Connecter des workflows de capture ou de transcription répétables sans exposer de secrets.

Public
Développeurs et utilisateurs avancés connectant Vowise à des workflows existants.
Temps
18 minutes
Niveau
Avancé

Scénario

Commencez par le workflow visé par ce guide avant de passer aux étapes.

En tant que créateur d'automatisation, je veux une manière répétable d'envoyer du son à Vowise afin de pouvoir connecter des outils de capture sans télécharger manuellement des fichiers.

Vous savez où les clés API s'intègrent, comment tester la référence publique et quelles règles de gestion de secrets suivre.

Étapes

1

Créer ou localiser une clé API

Utilisez l'interface de compte destinée aux clés API. Traitez la clé comme un secret, et non comme un contenu de tutoriel public.

La clé est stockée en dehors du dépôt.
Les captures d'écran masquent ou omettent la clé.
2

Tester la référence API publique

Utilisez `/api-reference` pour comprendre la forme de la requête de transcription et de dictionnaire publique avant de la mettre dans une automatisation.

Vous connaissez le format d'en-tête d'authentification.
Vous savez quels points de terminaison sont publics.
3

Construire l'enveloppe d'automatisation

Enveloppez la requête dans Raccourcis, un script local ou un workflow côté serveur qui peut garder la clé privée.

Le workflow n'imprime pas la clé dans les journaux.
Les échecs sont visibles sans exposer les informations d'identification.

Détails

Règles de gestion des secrets

La documentation peut enseigner la forme de la requête, mais les exemples doivent utiliser des espaces réservés au lieu de secrets réels, de mots de passe réutilisables ou d'URL privées.

  • Utilisez des espaces réservés dans la documentation et les captures d'écran.
  • Gardez les vraies clés dans des magasins de secrets locaux ou des configurations côté serveur.
  • Changez une clé si elle apparaît dans un enregistrement public.

Parcours de fonctions liés

Ce tutoriel ne doit pas être une impasse. Voici les prochaines fonctions et workflows naturels.