Webhook de capture

Le webhook de capture transforme une note vocale ou un court texte en tâche dans la boîte de réception. N'importe quel appareil, application ou script capable d'envoyer une requête HTTP transmet le texte, et éventuellement un enregistrement audio, à votre propre serveur cloud. Le serveur crée la tâche, y joint l'enregistrement, et vos appareils récupèrent les deux à la prochaine synchronisation.

Cela nécessite le serveur cloud auto-hébergé. Si vous utilisez Mindwtr sans serveur, capturez plutôt depuis le menu de partage du téléphone ou avec Siri.

Le point de terminaison

POST /v1/capture

Chaque requête porte le même jeton bearer que le reste de l'API, dans un en-tête Authorization: Bearer <token>. Le corps peut être multipart/form-data, application/json avec les mêmes noms de champs, ou text/plain, où tout le corps est la transcription. Seul multipart/form-data peut transporter de l'audio : les requêtes JSON et texte brut ne contiennent que du texte, et un champ audio placé dans le JSON est ignoré. Les champs inconnus sont ignorés.

Texte seul

curl -X POST https://your-server.example/v1/capture \
  -H "Authorization: Bearer $MINDWTR_TOKEN" \
  -H "Content-Type: text/plain" \
  --data "Call the dentist about the crown"

Audio avec une transcription

curl -X POST https://your-server.example/v1/capture \
  -H "Authorization: Bearer $MINDWTR_TOKEN" \
  -F "transcription=Call the dentist about the crown" \
  -F "audio=@note.m4a" \
  -F "recordedAt=1756900000000" \
  -F "client=Pebble Index 01"

Champs

Champ	Effet
transcription	Le texte capturé. La première ligne devient le titre de la tâche et le texte complet devient la description. text et title sont acceptés comme autres noms du même champ.
audio	L'enregistrement à joindre à la tâche. Il se synchronise vers vos appareils comme n'importe quelle autre pièce jointe. Il n'est lu que dans une requête multipart/form-data.
recordedAt	Le moment de la capture, en millisecondes depuis l'époque ou sous forme d'horodatage ISO 8601. Il devient la date de création de la tâche s'il est valide et pas dans le futur.
client	Une courte étiquette pour l'appareil ou l'application qui a envoyé la capture. Elle est acceptée et ignorée, afin que les expéditeurs comme l'application Pebble continuent de fonctionner.
captureId	Facultatif. Un UUID choisi par l'expéditeur pour cette capture ; il devient l'identifiant de la nouvelle tâche. Si vous renvoyez la même valeur lors d'une nouvelle tentative, le serveur répond 200 avec "replayed": true et n'ajoute rien. Une valeur mal formée est rejetée avec 400.

Envoyez au moins l'un des champs transcription et audio. L'enregistrement peut être en m4a, mp4, aac, mp3, wav, ogg ou webm.

Réponses

Statut	Signification
201	La tâche a été créée. Le corps de la réponse est la nouvelle tâche.
400	Ni transcription ni fichier audio n'a été envoyé.
401	Le jeton est absent ou incorrect.
413	La requête dépasse la taille maximale du serveur : un fichier audio au-delà de la limite des pièces jointes, ou une transcription au-delà de la limite de texte.
415	Le type du fichier audio n'est pas pris en charge.

Jeton de capture seule

Un appareil qui ne fait que capturer ne devrait pas détenir un jeton capable de lire, modifier et supprimer tout le contenu de votre compte. Un jeton de capture seule est un second secret pour le même compte. Le serveur l'accepte sur POST /v1/capture et nulle part ailleurs.

Créez-en un avec votre jeton complet. Le label est facultatif. La réponse affiche le jeton une seule fois. Le serveur ne le stocke jamais en clair, copiez-le donc maintenant.

curl -X POST https://your-server.example/v1/capture-tokens \
  -H "Authorization: Bearer $MINDWTR_TOKEN" \
  -H "Content-Type: application/json" \
  --data '{"label":"Pebble ring"}'

{
  "id": "6f1c2d1e-8a4b-4c3e-9f2a-1b2c3d4e5f60",
  "token": "mwc_…",
  "label": "Pebble ring",
  "createdAt": "2026-09-06T10:12:00.000Z"
}

Listez les jetons du compte. La réponse contient id, label et createdAt pour chaque jeton, et aucun secret.

curl https://your-server.example/v1/capture-tokens \
  -H "Authorization: Bearer $MINDWTR_TOKEN"

Révoquez-en un par son id.

curl -X DELETE https://your-server.example/v1/capture-tokens/<id> \
  -H "Authorization: Bearer $MINDWTR_TOKEN"

• Un jeton de capture seule ne fonctionne que sur POST /v1/capture. Il s'y comporte exactement comme le jeton complet : mêmes formats de corps, mêmes réponses, même limite de débit que le compte. Toute autre route répond 403.
• Un compte peut détenir jusqu'à 20 jetons de capture seule.
• En mode liste d'autorisation, un jeton de capture seule cesse de fonctionner quand le jeton complet du compte est retiré de la liste.

Pebble Index 01

L'application du Pebble Index 01 envoie les notes vocales exactement dans ce format et permet d'ajouter vos propres en-têtes de requête. Aucun code intermédiaire n'est donc nécessaire : vous remplissez seulement deux réglages.

1. Ouvrez l'application Pebble sur votre téléphone et allez dans les réglages de webhook des notes vocales
2. Indiquez comme URL de webhook https://your-server.example/v1/capture, avec l'adresse de votre propre serveur à la place de l'exemple
3. Ajoutez un en-tête de requête nommé Authorization avec la valeur Bearer <token>, en utilisant un jeton de capture seule de la section ci-dessus. Votre jeton complet fonctionne aussi, mais le jeton de capture seule est le choix le plus sûr pour un appareil qui ne fait qu'enregistrer des notes
4. Enregistrez une note sur la montre. Elle arrive dans votre boîte de réception à la prochaine synchronisation, avec la transcription comme tâche et l'enregistrement en pièce jointe

Autres appareils et automatisations

Rien de tout cela n'est propre à Pebble. Tout ce qui peut faire un POST HTTP fonctionne de la même façon :

• Raccourcis iOS et Apple Watch : une action Obtenir le contenu de l'URL, méthode POST, avec l'en-tête et un champ de texte. Consultez la recette Capturer depuis Apple Watch sur la page des Raccourcis Apple
• Applications d'automatisation Android comme Tasker : une action de requête HTTP avec la même URL et le même en-tête
• Home Assistant : un rest_command qui envoie le texte d'une automatisation ou d'une réponse de l'assistant vocal
• Scripts shell et tâches cron : les commandes curl ci-dessus, avec le jeton dans une variable d'environnement

Pages connexes

• API Cloud
• Capture par e-mail
• Déploiement Docker