用途:该技能基于 Telnyx Ruby SDK,提供电话号码信息查询与用户验证能力。安装方式:gem install telnyx;初始化需 require "telnyx" 并创建 Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。号码必须使用 E.164 格式(如 +13125550001)。
主要能力:1) 查询号码信息,GET /number_lookup/{phone_number},返回 caller_name、carrier、country_code、fraud、national_format、portability 等;2) 按号码列出验证记录,GET /verifications/by_phone_number/{phone_number},返回 status(pending、accepted、invalid、expired、error)与 type(sms、call、flashcall);3) 按号码校验验证码,POST /verifications/by_phone_number/{phone_number}/actions/verify,需 code 与 verify_profile_id;4) 触发语音、Flash call 或短信验证,POST /verifications/call、/flashcall、/sms,均需 phone_number 与 verify_profile_id;5) 按 ID 检索验证记录并校验;6) 管理 Verify profiles(列表、创建、检索、更新、删除),POST /verify_profiles 仅需 name;7) 管理 message templates(列表、创建、更新)。
错误处理:应捕获网络错误、429 限流、422 校验错误与 401 认证错误;429 建议按 Retry-After 以指数退避重试;常见状态码包括 401、403、404、422、429。
适用场景:手机号验证、用户注册与登录校验、号码数据充实、防欺诈查询等。限制:示例基于 Ruby 环境;验证码请求数量、定价、平台支持范围等资料暂未提供;仅凭本次资料无法确认其他语言版本或额外合规要求。