Pengembang · Zapier
Referensi API Zapier TypeHop
Aplikasi TypeHop di Zapier memiliki satu pemicu, New Dictation. Pemicu ini menggunakan empat endpoint di bawah dan menerima satu event. Semuanya JSON lewat HTTPS. Unduh spesifikasi OpenAPI 3.1.
Autentikasi
Setiap permintaan membawa kunci Zapier khusus sebagai token Bearer. Satu kunci dimiliki satu pengguna di satu workspace. Buat atau cabut kunci di typehop.com/zapier/connect. Workspace memerlukan paket dengan webhook (Pro atau lebih tinggi).
- URL dasar
https://api.typehop.com/v1/zapier- Header
Authorization: Bearer thp_zap_<64 hex characters>- Error
- Respons non-2xx mengembalikan
{ "error": "<message>" }dan tidak pernah di-cache.
Uji sebuah kunci
GEThttps://api.typehop.com/v1/zapier/auth
Memastikan kunci valid dan workspace dapat menggunakan webhook. Mengembalikan nama workspace yang ditampilkan Zapier sebagai label koneksi.
Digunakan oleh: Uji autentikasi
Respons · 200
{
"accountLabel": "Acme workspace"
}Error
401Kunci hilang, salah format, tidak valid, atau sudah dicabut.403Paket workspace tidak mencakup webhook (Pro atau lebih tinggi), atau langganan tidak aktif.
Daftar dikte terbaru
GEThttps://api.typehop.com/v1/zapier/notes
Sepuluh dikte terbaru milik pemilik kunci di workspace tersebut, yang terbaru lebih dulu. Zapier menggunakannya sebagai data contoh saat Anda membangun Zap.
Digunakan oleh: Pemicu New Dictation (performList)
Respons · 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"
}
]
}Error
401Kunci hilang, salah format, tidak valid, atau sudah dicabut.403Paket workspace tidak mencakup webhook (Pro atau lebih tinggi), atau langganan tidak aktif.
Berlangganan untuk sebuah Zap
POSThttps://api.typehop.com/v1/zapier/subscriptions
Mendaftarkan REST hook Zapier. Hanya URL HTTPS di hooks.zapier.com yang diterima. Berlangganan dengan URL yang sama dua kali mengembalikan langganan yang sudah ada. Setiap langganan dihitung terhadap batas webhook paket.
Digunakan oleh: Pemicu New Dictation (performSubscribe)
Isi permintaan
{
"targetUrl": "https://hooks.zapier.com/hooks/standard/123/abc/"
}Respons · 201
{
"id": "5d1f2c4e-8a1b-4f8e-9a77-3d2f6c1b0e21"
}Error
400JSON tidak valid, atau targetUrl bukan URL HTTPS hooks.zapier.com.401Kunci hilang, salah format, tidak valid, atau sudah dicabut.403Paket workspace tidak mencakup webhook (Pro atau lebih tinggi), atau langganan tidak aktif.403Batas webhook untuk paket telah tercapai.413Isi permintaan lebih besar dari 4 KB.
Berhenti berlangganan untuk sebuah Zap
DELETEhttps://api.typehop.com/v1/zapier/subscriptions/{id}
Menghapus langganan yang dibuat dengan kunci ini. ID yang tidak dikenal tetap berhasil tanpa pesan sehingga berhenti berlangganan yang diulang tetap aman.
Digunakan oleh: Pemicu New Dictation (performUnsubscribe)
Respons · 204
Tanpa isi.
Error
400ID bukan UUID.401Kunci hilang, salah format, tidak valid, atau sudah dicabut.
Event note.transcribed
Saat sebuah dikte siap, TypeHop mengirim POST ke setiap hook yang berlangganan. Header mencakup x-talktome-event dan x-talktome-event-id (note.transcribed:<note id>). Pengiriman yang gagal dicoba ulang dengan backoff; ID catatan tetap sama, sehingga duplikat dapat dibuang berdasarkan ID tersebut.
{
"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"
}
}Pemicu Zapier menghasilkan empat kolom: id, text (teks yang sudah dirapikan), createdAt, dan source.
Pengujian tanpa Mac
- Masuk di typehop.com/zapier/connect dan buat kunci Zapier.
- Di Zapier, hubungkan TypeHop dengan kunci itu, pilih New Dictation lalu aktifkan Zap.
- Kembali di halaman koneksi, rekam dikte singkat di browser atau ketik catatan uji, lalu tekan Send to my Zaps.
Zap berjalan dalam beberapa detik. Pertanyaan: support@typehop.com. Halaman kunci: https://typehop.com/zapier/connect.