用途：通过 curl 调用 Telnyx Numbers API，完成电话号码的搜索、订购、预留与管理，覆盖号码可用性、订单状态、号码块、国家覆盖等流程。
主要能力：搜索可用号码（GET /available_phone_numbers，返回 phone_number、quickship、reservable、best_effort、cost_information 等）；创建号码订单（POST /number_orders，必填 phone_numbers，可选 connection_id、messaging_profile_id、billing_group_id）；查询订单状态（GET /number_orders/{number_order_id}）；创建与查询号码预留（POST/GET /number_reservations）；高级订单的列表、创建、更新与查询（/advanced_orders）；可用号码块（GET /available_phone_number_blocks）；评论（/comments）；国家覆盖（/country_coverage）；客户服务记录、号码块订单、子号码订单及报告等。
使用方式：curl 已预装于 macOS、Linux 和 Windows 10+。设置 export TELNYX_API_KEY="YOUR_API_KEY_HERE"，请求头使用 Authorization: Bearer $TELNYX_API_KEY。号码须为 E.164 格式（如 +13125550001），含 + 和国家代码，无空格、短横线或括号。列表接口分页，使用 page[number] 和 page[size]，检查 meta.total_pages。
限制与错误：可能遇到网络错误、429 限流、422 校验错误、401 认证错误；常见代码 401 无效密钥、403 权限不足、404 资源不存在、422 字段格式错误、429 限流（指数退避重试）。不要臆造参数、枚举、响应字段或 webhook 字段；未内联展示的字段需先查阅 references/api-details.md。使用 Additional Operations 前需阅读可选参数与响应模式章节。webhook 事件如 numberOrderStatusUpdate（number.order.status.update）。具体收费、价格与平台支持情况暂未提供。