개발자 · 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
해당 워크스페이스에서 키 소유자의 최근 받아쓰기 10개를 최신순으로 반환합니다. Zapier는 Zap을 만드는 동안 이를 샘플 데이터로 사용합니다.
사용처: 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 훅을 등록합니다. 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"
}오류
400JSON이 올바르지 않거나, targetUrl이 HTTPS hooks.zapier.com 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이 구독된 모든 훅에 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 없이 테스트하기
- Sign in at typehop.com/zapier/connect에 로그인해 Zapier 키를 만드세요.
- Zapier에서 그 키로 TypeHop을 연결하고 New Dictation을(를) 선택한 뒤 Zap을 켜세요.
- 연결 페이지로 돌아와 브라우저에서 짧은 받아쓰기를 녹음하거나 테스트 노트를 입력한 다음 Send to my Zaps를 누르세요.
Zap은 몇 초 안에 실행됩니다. 문의: support@typehop.com. 키 페이지: https://typehop.com/zapier/connect.