SuperAPI AI 工具集

telnyx-verify-python

编程与开发

查看项目

更新于 10-16 03:37

技能介绍

用途:通过 Telnyx 官方 Python SDK 完成两类任务——电话号码信息查询(数据丰富)与用户身份验证(OTP)。

主要能力:

  1. 号码查询:client.number_lookup.retrieve 返回 caller_name、carrier、country_code、fraud、national_format、phone_number、portability 等字段。
  2. 验证码发送:支持短信 trigger_sms、语音 trigger_call、闪呼 trigger_flashcall、WhatsApp trigger_whatsapp_verification。
  3. 验证码校验:按手机号 by_phone_number.actions.verify 或按验证 ID verifications.actions.verify,返回 response_code(accepted/rejected)。
  4. 验证记录:按手机号列出 verifications,retrieve 单个验证,状态含 pending、accepted、invalid、expired、error。
  5. 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 响应头。

费用、配额、地区可用性等资料暂未提供。