메인 콘텐츠로 건너뛰기
API 계약을 바탕으로 이 쪽을 만들어요. 이 목록과 OpenAPI 파일에 있는 경로와 필드만 써 주세요.
  • API 주소: https://api.telkit.io
  • 요청과 응답 모양: openapi.json
  • 인증: 첫 연결을 마치고 받은 자격을 Authorization: Bearer로 보내요. 첫 연결 링크 생성과 그 작업 조회는 인증 헤더 없이 시작해요
  • 사람이 하는 일: 본인인증, 약관 동의, 카드 등록, 충전, 결제 재시도는 사람이 직접 해요. 에이전트는 이 경로를 호출하지 않아요.

첫 연결과 링크

  • POST /v1/account/link: create_account_link
  • POST /v1/api-keys: exchange_connect_token
  • DELETE /v1/api-keys/{id}: revoke_api_key
  • POST /v1/balance/top-ups: create_topup_link
  • POST /v1/connect-links: create_connect_link
  • GET /v1/human-tasks/{id}: get_human_task
  • POST /v1/human-tasks/{id}/cancel: cancel_human_task
  • POST /v1/human-tasks/{id}/link: reissue_human_link
  • GET /v1/workspace: get_workspace

계정 준비

  • GET /v1/legal-documents: list_legal_documents
  • GET /v1/me: get_me

번호와 수신

  • GET /v1/numbers: list_numbers
  • POST /v1/numbers: issue_number
  • GET /v1/numbers/available: list_available_numbers
  • GET /v1/numbers/{id}: get_number
  • DELETE /v1/numbers/{id}: release_number
  • PUT /v1/numbers/{id}/connection: put_number_connection
  • PUT /v1/numbers/{id}/max-duration: put_number_max_duration

통화 기록

  • GET /v1/calls/{telkit_call_id}: get_call
  • GET /v1/numbers/{id}/calls: list_number_calls

발신 접속 정보

  • POST /v1/numbers/{id}/sip-credential: create_sip_password
  • PUT /v1/numbers/{id}/sip-credential: set_sip_username
  • DELETE /v1/numbers/{id}/sip-credential: delete_sip_password
  • POST /v1/numbers/{id}/sip-credential/rotate: rotate_sip_password
  • GET /v1/sip-credentials: list_sip_credentials
  • GET /v1/sip-trunk: get_sip_trunk
  • GET /v1/sip-trunk/ip-allowlist: list_sip_ip_allowlist
  • POST /v1/sip-trunk/ip-allowlist: add_sip_ip_allow
  • DELETE /v1/sip-trunk/ip-allowlist/{id}: remove_sip_ip_allow

발신표기번호

  • GET /v1/caller-ids: list_caller_ids
  • POST /v1/caller-ids: register_caller_id
  • GET /v1/caller-ids/{id}: get_caller_id
  • POST /v1/caller-ids/{id}/documents: upload_caller_id_document
  • PUT /v1/numbers/{id}/caller-id: put_number_caller_id
  • DELETE /v1/numbers/{id}/caller-id: reset_number_caller_id

잔액과 결제

  • GET /v1/billing/auto-topup: get_auto_topup_settings
  • GET /v1/billing/auto-topup/defaults: get_auto_topup_defaults
  • GET /v1/billing/balance: get_billing_balance
  • GET /v1/billing/summary: get_billing_summary
  • GET /v1/billing/topups/{id}: get_balance_topup
  • POST /v1/payment-methods/session: create_card_session

사업자 인증

  • GET /v1/workspace/business-verification: get_business_verification
  • POST /v1/workspace/business-verification: start_business_verification
  • POST /v1/workspace/business-verification/document: upload_business_verification_document

사람이 직접 하는 일

에이전트는 아래 경로를 호출하지 않아요. 사람이 자신의 화면에서 직접 해요.
  • POST /v1/billing/topups: request_balance_topup
  • POST /v1/consents: record_consents
  • POST /v1/identity/verify: verify_identity
  • POST /v1/numbers/{id}/billing/retry: retry_number_payment