- API 주소:
https://api.telkit.io - 요청과 응답 모양: openapi.json
- 인증: 첫 연결을 마치고 받은 자격을
Authorization: Bearer로 보내요. 첫 연결 링크 생성과 그 작업 조회는 인증 헤더 없이 시작해요 - 사람이 하는 일: 본인인증, 약관 동의, 카드 등록, 충전, 결제 재시도는 사람이 직접 해요. 에이전트는 이 경로를 호출하지 않아요.
첫 연결과 링크
POST /v1/account/link: create_account_linkPOST /v1/api-keys: exchange_connect_tokenDELETE /v1/api-keys/{id}: revoke_api_keyPOST /v1/balance/top-ups: create_topup_linkPOST /v1/connect-links: create_connect_linkGET /v1/human-tasks/{id}: get_human_taskPOST /v1/human-tasks/{id}/cancel: cancel_human_taskPOST /v1/human-tasks/{id}/link: reissue_human_linkGET /v1/workspace: get_workspace
계정 준비
GET /v1/legal-documents: list_legal_documentsGET /v1/me: get_me
번호와 수신
GET /v1/numbers: list_numbersPOST /v1/numbers: issue_numberGET /v1/numbers/available: list_available_numbersGET /v1/numbers/{id}: get_numberDELETE /v1/numbers/{id}: release_numberPUT /v1/numbers/{id}/connection: put_number_connectionPUT /v1/numbers/{id}/max-duration: put_number_max_duration
통화 기록
GET /v1/calls/{telkit_call_id}: get_callGET /v1/numbers/{id}/calls: list_number_calls
발신 접속 정보
POST /v1/numbers/{id}/sip-credential: create_sip_passwordPUT /v1/numbers/{id}/sip-credential: set_sip_usernameDELETE /v1/numbers/{id}/sip-credential: delete_sip_passwordPOST /v1/numbers/{id}/sip-credential/rotate: rotate_sip_passwordGET /v1/sip-credentials: list_sip_credentialsGET /v1/sip-trunk: get_sip_trunkGET /v1/sip-trunk/ip-allowlist: list_sip_ip_allowlistPOST /v1/sip-trunk/ip-allowlist: add_sip_ip_allowDELETE /v1/sip-trunk/ip-allowlist/{id}: remove_sip_ip_allow
발신표기번호
GET /v1/caller-ids: list_caller_idsPOST /v1/caller-ids: register_caller_idGET /v1/caller-ids/{id}: get_caller_idPOST /v1/caller-ids/{id}/documents: upload_caller_id_documentPUT /v1/numbers/{id}/caller-id: put_number_caller_idDELETE /v1/numbers/{id}/caller-id: reset_number_caller_id
잔액과 결제
GET /v1/billing/auto-topup: get_auto_topup_settingsGET /v1/billing/auto-topup/defaults: get_auto_topup_defaultsGET /v1/billing/balance: get_billing_balanceGET /v1/billing/summary: get_billing_summaryGET /v1/billing/topups/{id}: get_balance_topupPOST /v1/payment-methods/session: create_card_session
사업자 인증
GET /v1/workspace/business-verification: get_business_verificationPOST /v1/workspace/business-verification: start_business_verificationPOST /v1/workspace/business-verification/document: upload_business_verification_document
사람이 직접 하는 일
에이전트는 아래 경로를 호출하지 않아요. 사람이 자신의 화면에서 직접 해요.POST /v1/billing/topups: request_balance_topupPOST /v1/consents: record_consentsPOST /v1/identity/verify: verify_identityPOST /v1/numbers/{id}/billing/retry: retry_number_payment