TypeHop
डाउनलोड

डेवलपर्स · 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

कोई बॉडी नहीं।

त्रुटियाँ

  • 400 ID कोई 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 के बिना टेस्टिंग

  1. यहाँ साइन इन करें: typehop.com/zapier/connect और एक Zapier कुंजी बनाएँ।
  2. Zapier में उसी कुंजी से TypeHop कनेक्ट करें, New Dictation चुनें और Zap चालू करें।
  3. कनेक्ट पेज पर वापस आकर ब्राउज़र में एक छोटा डिक्टेशन रिकॉर्ड करें या टेस्ट नोट टाइप करें, फिर Send to my Zaps दबाएँ।

Zap कुछ ही सेकंड में चलता है। सवाल: support@typehop.com। कुंजी पेज: https://typehop.com/zapier/connect।

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