डेवलपर्स · Zapier
TypeHop Zapier API रेफ़रेंस
Zapier पर TypeHop ऐप में एक ही ट्रिगर है, New Dictation। यह नीचे दिए चार एंडपॉइंट इस्तेमाल करता है और एक इवेंट पाता है। सब कुछ HTTPS पर JSON में है। OpenAPI 3.1 स्पेक डाउनलोड करें।
ऑथेंटिकेशन
हर रिक्वेस्ट में एक समर्पित Zapier कुंजी Bearer टोकन के रूप में जाती है। एक कुंजी एक वर्कस्पेस में एक यूज़र की होती है। कुंजियाँ यहाँ बनाएँ या रद्द करें: typehop.com/zapier/connect। वर्कस्पेस के पास वेबहुक वाला प्लान (Pro या उससे ऊपर) होना चाहिए।
- बेस URL
https://api.typehop.com/v1/zapier- हेडर
Authorization: Bearer thp_zap_<64 hex characters>- त्रुटियाँ
- गैर-2xx रिस्पॉन्स
{ "error": "<message>" }लौटाते हैं और कभी कैश नहीं किए जाते।
कुंजी टेस्ट करें
GEThttps://api.typehop.com/v1/zapier/auth
पुष्टि करता है कि कुंजी मान्य है और वर्कस्पेस वेबहुक इस्तेमाल कर सकता है। वर्कस्पेस का वह नाम लौटाता है जिसे Zapier कनेक्शन लेबल के रूप में दिखाता है।
इस्तेमाल करने वाला: ऑथेंटिकेशन टेस्ट
रिस्पॉन्स · 200
{
"accountLabel": "Acme workspace"
}त्रुटियाँ
401कुंजी गायब, गलत फ़ॉर्मेट वाली, अमान्य या रद्द है।403वर्कस्पेस के प्लान में वेबहुक शामिल नहीं हैं (Pro या उससे ऊपर), या सब्सक्रिप्शन सक्रिय नहीं है।
हाल के डिक्टेशन की सूची
GEThttps://api.typehop.com/v1/zapier/notes
उस वर्कस्पेस में कुंजी के मालिक के दस सबसे हाल के डिक्टेशन, सबसे नए पहले। Zap बनाते समय Zapier इन्हें सैंपल डेटा के रूप में इस्तेमाल करता है।
इस्तेमाल करने वाला: New Dictation ट्रिगर (performList)
रिस्पॉन्स · 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"
}
]
}त्रुटियाँ
401कुंजी गायब, गलत फ़ॉर्मेट वाली, अमान्य या रद्द है।403वर्कस्पेस के प्लान में वेबहुक शामिल नहीं हैं (Pro या उससे ऊपर), या सब्सक्रिप्शन सक्रिय नहीं है।
Zap को सब्सक्राइब करें
POSThttps://api.typehop.com/v1/zapier/subscriptions
एक Zapier REST hook रजिस्टर करता है। सिर्फ़ hooks.zapier.com के HTTPS URL स्वीकार किए जाते हैं। एक ही URL को दो बार सब्सक्राइब करने पर मौजूदा सब्सक्रिप्शन लौटता है। हर सब्सक्रिप्शन प्लान की वेबहुक सीमा में गिना जाता है।
इस्तेमाल करने वाला: New Dictation ट्रिगर (performSubscribe)
रिक्वेस्ट बॉडी
{
"targetUrl": "https://hooks.zapier.com/hooks/standard/123/abc/"
}रिस्पॉन्स · 201
{
"id": "5d1f2c4e-8a1b-4f8e-9a77-3d2f6c1b0e21"
}त्रुटियाँ
400अमान्य JSON, या targetUrl hooks.zapier.com का HTTPS URL नहीं है।401कुंजी गायब, गलत फ़ॉर्मेट वाली, अमान्य या रद्द है।403वर्कस्पेस के प्लान में वेबहुक शामिल नहीं हैं (Pro या उससे ऊपर), या सब्सक्रिप्शन सक्रिय नहीं है।403प्लान की वेबहुक सीमा पूरी हो चुकी है।413रिक्वेस्ट बॉडी 4 KB से बड़ी है।
Zap को अनसब्सक्राइब करें
DELETEhttps://api.typehop.com/v1/zapier/subscriptions/{id}
इस कुंजी से बनाया गया सब्सक्रिप्शन हटाता है। अज्ञात ID चुपचाप सफल हो जाती हैं, ताकि दोबारा की गई अनसब्सक्राइब रिक्वेस्ट सुरक्षित रहे।
इस्तेमाल करने वाला: New Dictation ट्रिगर (performUnsubscribe)
रिस्पॉन्स · 204
कोई बॉडी नहीं।
त्रुटियाँ
400ID कोई UUID नहीं है।401कुंजी गायब, गलत फ़ॉर्मेट वाली, अमान्य या रद्द है।
note.transcribed इवेंट
डिक्टेशन तैयार होने पर TypeHop हर सब्सक्राइब किए गए hook को एक POST भेजता है। हेडर में x-talktome-event और x-talktome-event-id (note.transcribed:<note id>) शामिल हैं। विफल डिलीवरी बैकऑफ़ के साथ दोबारा आज़माई जाती हैं; नोट ID वही रहती है, इसलिए उसी से डुप्लिकेट हटाए जा सकते हैं।
{
"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"
}
}Zapier ट्रिगर चार फ़ील्ड आउटपुट करता है: id, text (साफ़ किया हुआ टेक्स्ट), createdAt और source।
Mac के बिना टेस्टिंग
- यहाँ साइन इन करें: typehop.com/zapier/connect और एक Zapier कुंजी बनाएँ।
- Zapier में उसी कुंजी से TypeHop कनेक्ट करें, New Dictation चुनें और Zap चालू करें।
- कनेक्ट पेज पर वापस आकर ब्राउज़र में एक छोटा डिक्टेशन रिकॉर्ड करें या टेस्ट नोट टाइप करें, फिर Send to my Zaps दबाएँ।
Zap कुछ ही सेकंड में चलता है। सवाल: support@typehop.com। कुंजी पेज: https://typehop.com/zapier/connect।