Entwickler · Zapier
Referenz zur TypeHop-Zapier-API
Die TypeHop-App auf Zapier hat einen Trigger, New Dictation. Sie nutzt die vier Endpunkte unten und empfängt ein Ereignis. Alles ist JSON über HTTPS. OpenAPI-3.1-Spezifikation herunterladen.
Authentifizierung
Jede Anfrage enthält einen eigenen Zapier-Schlüssel als Bearer-Token. Ein Schlüssel gehört einem Nutzer in einem Workspace. Schlüssel erstellen oder widerrufen Sie unter typehop.com/zapier/connect. Der Workspace benötigt einen Tarif mit Webhooks (Pro oder höher).
- Basis-URL
https://api.typehop.com/v1/zapier- Header
Authorization: Bearer thp_zap_<64 hex characters>- Fehler
- Antworten ausserhalb von 2xx liefern
{ "error": "<message>" }und werden nie gecacht.
Schlüssel testen
GEThttps://api.typehop.com/v1/zapier/auth
Bestätigt, dass der Schlüssel gültig ist und der Workspace Webhooks nutzen kann. Gibt den Workspace-Namen zurück, den Zapier als Verbindungsbezeichnung anzeigt.
Verwendet von: Authentifizierungstest
Antwort · 200
{
"accountLabel": "Acme workspace"
}Fehler
401Schlüssel fehlt, ist fehlerhaft, ungültig oder widerrufen.403Der Tarif des Workspace enthält keine Webhooks (Pro oder höher), oder das Abonnement ist nicht aktiv.
Letzte Diktate auflisten
GEThttps://api.typehop.com/v1/zapier/notes
Die zehn neuesten Diktate des Schlüsselinhabers in diesem Workspace, neueste zuerst. Zapier nutzt sie als Beispieldaten, während Sie einen Zap erstellen.
Verwendet von: New-Dictation-Trigger (performList)
Antwort · 200
{
"notes": [
{
"id": "a0cf17ac-0c67-49df-a875-05c84063161c",
"cleanedText": "Idea: let teammates share a custom dictionary.",
"startedAt": "2026-11-10T10:00:00.000Z",
"source": "macos"
}
]
}Fehler
401Schlüssel fehlt, ist fehlerhaft, ungültig oder widerrufen.403Der Tarif des Workspace enthält keine Webhooks (Pro oder höher), oder das Abonnement ist nicht aktiv.
Einen Zap abonnieren
POSThttps://api.typehop.com/v1/zapier/subscriptions
Registriert einen Zapier-REST-Hook. Es werden nur HTTPS-URLs auf hooks.zapier.com akzeptiert. Wird dieselbe URL zweimal abonniert, wird das bestehende Abonnement zurückgegeben. Jedes Abonnement zählt zum Webhook-Limit des Tarifs.
Verwendet von: New-Dictation-Trigger (performSubscribe)
Request-Body
{
"targetUrl": "https://hooks.zapier.com/hooks/standard/123/abc/"
}Antwort · 201
{
"id": "5d1f2c4e-8a1b-4f8e-9a77-3d2f6c1b0e21"
}Fehler
400Ungültiges JSON, oder targetUrl ist keine HTTPS-URL auf hooks.zapier.com.401Schlüssel fehlt, ist fehlerhaft, ungültig oder widerrufen.403Der Tarif des Workspace enthält keine Webhooks (Pro oder höher), oder das Abonnement ist nicht aktiv.403Das Webhook-Limit des Tarifs ist erreicht.413Request-Body grösser als 4 KB.
Einen Zap abbestellen
DELETEhttps://api.typehop.com/v1/zapier/subscriptions/{id}
Entfernt ein mit diesem Schlüssel erstelltes Abonnement. Unbekannte IDs gelten stillschweigend als erfolgreich, sodass ein wiederholtes Abbestellen sicher ist.
Verwendet von: New-Dictation-Trigger (performUnsubscribe)
Antwort · 204
Kein Body.
Fehler
400Die ID ist keine UUID.401Schlüssel fehlt, ist fehlerhaft, ungültig oder widerrufen.
Das Ereignis note.transcribed
Sobald ein Diktat fertig ist, sendet TypeHop einen POST an jeden abonnierten Hook. Die Header enthalten x-talktome-event und x-talktome-event-id (note.transcribed:<note id>). Fehlgeschlagene Zustellungen werden mit Backoff wiederholt; die Notiz-ID bleibt gleich, sodass Duplikate anhand dieser ID verworfen werden können.
{
"event": "note.transcribed",
"timestamp": "2026-11-10T10:00:04.112Z",
"note": {
"id": "a0cf17ac-0c67-49df-a875-05c84063161c",
"cleanedText": "Idea: let teammates share a custom dictionary.",
"startedAt": "2026-11-10T10:00:00.000Z",
"source": "macos"
}
}Der Zapier-Trigger gibt vier Felder aus: id, text (der bereinigte Text), createdAt und source.
Testen ohne Mac
- Melden Sie sich unter typehop.com/zapier/connect an und erstellen Sie einen Zapier-Schlüssel.
- Verbinden Sie in Zapier TypeHop mit diesem Schlüssel, wählen Sie New Dictation und schalten Sie den Zap ein.
- Nehmen Sie auf der Verbindungsseite ein kurzes Diktat im Browser auf oder tippen Sie eine Testnotiz, und klicken Sie dann auf Send to my Zaps.
Der Zap läuft innerhalb weniger Sekunden. Fragen: support@typehop.com. Schlüsselseite: https://typehop.com/zapier/connect.