用途:通过 Telnyx 官方 Python SDK 完成两类任务——电话号码信息查询(数据丰富)与用户身份验证(OTP)。
主要能力:
- 号码查询:client.number_lookup.retrieve 返回 caller_name、carrier、country_code、fraud、national_format、phone_number、portability 等字段。
- 验证码发送:支持短信 trigger_sms、语音 trigger_call、闪呼 trigger_flashcall、WhatsApp trigger_whatsapp_verification。
- 验证码校验:按手机号 by_phone_number.actions.verify 或按验证 ID verifications.actions.verify,返回 response_code(accepted/rejected)。
- 验证记录:按手机号列出 verifications,retrieve 单个验证,状态含 pending、accepted、invalid、expired、error。
- Verify 配置:verify_profiles 的增删改查,含 webhook_url、webhook_failover_url、daily_spend_limit、language 及消息模板 create/update/retrieve_templates。
使用方式:pip install telnyx 安装;用 api_key=os.environ.get("TELNYX_API_KEY") 初始化 Telnyx 客户端。手机号必须为 E.164 格式(如 +13125550001),含 + 与国家码,不能有空格、连字符或括号。列表方法返回自动分页迭代器,可用 for item in page_result 遍历全部页。
限制与错误处理:API 调用可能因网络错误、限流(429)、校验错误(422)、鉴权错误(401)失败;生产代码应捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError。限流建议指数退避重试,参考 Retry-After 响应头。
费用、配额、地区可用性等资料暂未提供。