SuperAPI AI 工具集

telnyx-messaging-profiles-curl

通用与其它

查看项目

更新于 10-16 08:41

技能介绍

用途:通过 curl 调用 Telnyx Messaging Profiles API,创建和管理消息配置文件,配置号码池、粘性发送(sticky sender)、地理匹配(geomatch)等特性,并可为高并发消息配置短代码(short codes)。

主要能力:列出、创建、检索、更新、删除消息配置文件;列出配置文件关联的电话号码与短代码;列出、检索、更新短代码(可将短代码绑定或解绑到配置文件,messaging_profile_id 设为 null 或空字符串即解绑,并支持 tags 数组)。创建配置文件时必填 name 与 whitelisted_destinations,可选字段包括 alpha_sender、daily_spend_limit、daily_spend_limit_enabled、enabled、health_webhook_url、mms_fall_back_to_sms、mms_transcoding、mobile_only、number_pool_settings、resource_group_id、smart_encoding、url_shortener_settings、webhook_api_version、webhook_failover_url、webhook_url 等。

使用方式:curl 在 macOS、Linux、Windows 10+ 已预装。先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有请求使用 Authorization: Bearer $TELNYX_API_KEY 认证。示例:GET https://api.telnyx.com/v2/messaging_profiles 列出配置文件;POST 同路径创建;GET/PATCH/DELETE https://api.telnyx.com/v2/messaging_profiles/{id} 检索、更新、删除;GET .../{id}/phone_numbers 与 .../{id}/short_codes 列出关联资源;GET https://api.telnyx.com/v2/short_codes 列出短代码;GET/PATCH https://api.telnyx.com/v2/short_codes/{id} 检索与更新短代码。

错误处理:需处理网络错误、429 限流、422 校验错误、401 认证错误。常见状态码:401 无效 API 密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流(建议指数退避重试)。

分页:列表接口返回分页结果,使用 page[number] 与 page[size] 查询参数翻页,并检查响应中的 meta.total_pages。

限制:资料未提供具体价格、配额上限、速率限制数值及平台支持范围等细节。