SuperAPI AI 工具集

telnyx-fax-go

通用与其它

查看项目

更新于 10-16 05:43

技能介绍

用途:该技能提供 Telnyx Programmable Fax API 的 Go SDK 示例,帮助开发者用 Go 以编程方式发送、接收和管理传真。

安装:go get github.com/team-telnyx/telnyx-go。初始化客户端使用 telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY")))。

主要能力:传真应用管理,支持列出、创建、获取、更新和删除 Fax Applications(GET/POST /fax_applications,GET/PATCH/DELETE /fax_applications/{id});传真操作,支持列出传真(GET /faxes)、发送传真(POST /faxes)、查看(GET /faxes/{id})、删除(DELETE /faxes/{id})、取消(POST /faxes/{id}/actions/cancel)和刷新入站传真媒体链接(POST /faxes/{id}/actions/refresh)。发送传真时 connection_id、from、to 为必填,可选 media_url、quality、t38_enabled、store_media 等参数。文件大小超过 50MB 或页数超过 350 会分别报 file_size_limit_exceeded 和 page_count_limit_exceeded。

必要用法与限制:电话号码须为 E.164 格式(含 + 和国家代码,不要空格、连字符或括号)。生产代码应处理 401、403、404、422、429 等错误,429 需退避重试;列表可用 ListAutoPaging() 自动翻页。Webhook 使用 Ed25519 签名,请求带 telnyx-signature-ed25519 与 telnyx-timestamp 头,需用 client.Webhooks.Unwrap 校验,支持 fax.delivered、fax.failed、fax.media.processed、fax.queued、fax.sending.started 等事件。价格、费率与具体配额资料暂未提供。