用途
telnyx-porting-in-curl 面向需要将电话号码携入（Port In）Telnyx 平台的开发者。它把携号转入相关的 REST API 以 curl 命令的形式组织起来，方便在命令行、脚本或自动化流程中直接调用。
主要能力
根据资料，该技能覆盖以下 API 能力：
- 携号可行性检查：POST /portability_checks，返回 fast_portable、not_portable_reason、phone_number、portable 等。
- 携转事件：GET /porting/events（列出全部）、GET /porting/events/{id}（查看单个）、POST /porting/events/{id}/republish（重新发布事件）。
- LOA 配置：GET /porting/loa_configurations（列出）、POST /porting/loa_configurations（创建）、POST /porting/loa_configurations/preview（预览模板参数）、GET /porting/loa_configurations/{id}（获取）、PATCH /porting/loa_configurations/{id}（更新）、DELETE /porting/loa_configurations/{id}（删除）、GET /porting/loa_configurations/{id}/preview（预览单个配置）。
- 携转报告：GET /porting/reports（列出）、POST /porting/reports（创建）、GET /porting/reports/{id}（获取）。
- 英国运营商：GET /porting/uk_carriers（列出可用运营商）。
- 携转订单：GET /porting_orders（列出）、POST /porting_orders（创建，必填 phone_numbers）、GET /porting_orders/{id}（详情）、PATCH /porting_orders/{id}（编辑）、DELETE /porting_orders/{id}（删除，仅限草稿状态）。
- 订单异常类型：GET /porting_orders/exception_types。
- 电话号码配置：GET /porting_orders/phone_number_configurations（列出）、POST /porting_orders/phone_number_configurations（创建）。
- 订单操作：POST /porting_orders/{id}/actions/activate（异步激活，仅限 US FastPort 订单）、POST /porting_orders/{id}/actions/cancel（取消）、POST /porting_orders/{id}/actions/confirm（确认并提交）。
使用方式
- 安装：curl 在 macOS、Linux 和 Windows 10+ 上已预装。
- 认证：导出环境变量 export TELNYX_API_KEY="YOUR_API_KEY_HERE"，示例使用 $TELNYX_API_KEY 以 Bearer 方式认证。
- 电话号码格式：必须为 E.164 格式（如 +13125550001），包含 + 前缀和国家代码，不含空格、连字符或括号。
- 分页：列表接口返回分页结果，使用 page[number] 和 page[size] 查询参数翻页，并通过响应中的 meta.total_pages 判断总页数。
- 错误处理：资料给出了检查 HTTP 状态码的示例写法，并列出常见错误码含义——401 无效 API key、403 权限不足、404 资源不存在、422 校验错误（检查字段格式）、429 触发限流（用指数退避重试），并提示在生产代码中始终处理网络错误、限流、校验错误与认证错误。
适用场景
适用于需要以命令行/脚本方式完成携号可行性检查、创建与管理携转订单、维护 LOA 文档、跟踪携转事件与生成携转报告的开发与运维工作流。
限制
- 删除携转订单的操作仅限于 draft（草稿）状态的订单。
- 异步激活操作仅限 US FastPort 订单。
- 资料未提供具体的费率、价格、配额或服务等级等信息。
- 资料未提供除 curl 以外的其他语言 SDK 或集成方式说明。