SuperAPI AI 工具集

telnyx-porting-out-go

通用与其它

查看项目

更新于 10-16 06:24

技能介绍

用途:该技能针对号码从 Telnyx 转出(port-out)场景,提供 Go 语言 SDK 示例,帮助在 Go 项目中管理转出请求与状态。适合需要批量跟踪转出进度、更新转出状态或生成转出报表的电信业务开发者。

主要能力(均对应 REST 接口的 Go 调用):列出转出请求(GET /portouts)与查看单个请求(GET /portouts/{id}),返回状态枚举含 pending、authorized、ported、rejected、rejected-pending、canceled 等字段;列出与查看转出事件(GET /portouts/events、GET /portouts/events/{id}),并支持重发事件(POST /portouts/events/{id}/republish);查询某订单可用的拒绝代码(GET /portouts/rejections/{portout_id});创建与检索转出报表(POST/GET /portouts/reports、/portouts/reports/{id});管理转出请求的评论(GET/POST /portouts/{id}/comments)与支持性文档(GET/POST /portouts/{id}/supporting_documents);通过 PATCH /portouts/{id}/{status} 授权或拒绝转出,需提供 reason,可选 host_messaging。

使用方式:先安装 SDK:go get github.com/team-telnyx/telnyx-go。使用 option.WithAPIKey(os.Getenv("TELNYX_API_KEY")) 初始化 client,然后调用对应方法,例如 client.Portouts.List、client.Portouts.Get、client.Portouts.UpdateStatus、client.Portouts.Reports.New 等。列表接口可用 ListAutoPaging() 自动分页遍历。

限制与注意:所有 API 调用都可能因网络、限流(429)、校验(422)或鉴权(401)失败,生产代码应处理错误并在限流时退避重试。常见错误码另有 403 权限不足、404 资源不存在。文档未提供定价、平台兼容性或额外使用限制等信息。