TypeHop
Herunterladen

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

  • 401 Schlüssel fehlt, ist fehlerhaft, ungültig oder widerrufen.
  • 403 Der 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

  • 401 Schlüssel fehlt, ist fehlerhaft, ungültig oder widerrufen.
  • 403 Der 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

  • 400 Ungültiges JSON, oder targetUrl ist keine HTTPS-URL auf hooks.zapier.com.
  • 401 Schlüssel fehlt, ist fehlerhaft, ungültig oder widerrufen.
  • 403 Der Tarif des Workspace enthält keine Webhooks (Pro oder höher), oder das Abonnement ist nicht aktiv.
  • 403 Das Webhook-Limit des Tarifs ist erreicht.
  • 413 Request-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

  • 400 Die ID ist keine UUID.
  • 401 Schlü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

  1. Melden Sie sich unter typehop.com/zapier/connect an und erstellen Sie einen Zapier-Schlüssel.
  2. Verbinden Sie in Zapier TypeHop mit diesem Schlüssel, wählen Sie New Dictation und schalten Sie den Zap ein.
  3. 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.

Other products from us:SmashSend·TidySupport·SuperBuilder·Inbounter·Blossu·KnowledgeSDK