SuperAPI AI 工具集

telnyx-networking-curl

通用与其它

查看项目

更新于 10-16 05:41

技能介绍

用途:该技能以 curl 示例演示如何调用 Telnyx Networking REST API,用于配置和管理私有网络、Global IP、WireGuard 相关网关及互联网网关等网络资源,并获取用量、健康与延迟等指标。

主要能力:涵盖网络(networks)的增删改查、默认网关(default_gateway)的查询、创建与删除;Global IP 的创建、检索与删除;Global IP 分配(global_ip_assignments)的增删改查;Global IP 健康检查类型与健康检查的查询、创建与删除;Global IP 允许端口、协议列表;以及 Global IP 用量、分配用量、延迟、分配健康检查等指标接口。

使用方式:curl 在 macOS、Linux 和 Windows 10+ 已预装,无需安装。先设置环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE",所有请求使用 Authorization: Bearer $TELNYX_API_KEY 头,基址为 https://api.telnyx.com/v2,示例均以 $TELNYX_API_KEY 认证。列表接口支持分页,可用 page[number] 与 page[size] 参数,并检查响应中的 meta.total_pages。

限制与错误处理:所有 API 调用可能因网络错误、速率限制(429)、校验错误(422)或认证错误(401)失败,生产代码需处理:401 无效 API 密钥、403 权限不足、404 资源不存在、422 校验错误、429 限流(建议指数退避重试)。响应状态码可通过 curl 的 -w "%{http_code}" 获取并分支处理。资料未提供各接口的完整请求体字段说明、价格、配额或平台支持细节。