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

해당 워크스페이스에서 키 소유자의 최근 받아쓰기 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"
}

오류

  • 400 JSON이 올바르지 않거나, 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

본문 없음.

오류

  • 400 ID가 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 없이 테스트하기

  1. Sign in at 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