用途:通过 Telnyx 官方 JavaScript SDK 管理电话号码,包括搜索可用号码、创建号码订单、查询订单状态、预订号码以及查询覆盖范围等。
安装与初始化:使用 npm install telnyx@6.74.2 安装。初始化时导入 Telnyx 并使用 API Key:import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'] });
主要能力:搜索可用号码 client.availablePhoneNumbers.list()(GET /available_phone_numbers);创建号码订单 client.numberOrders.create()(POST /number_orders),可指定 phone_numbers、connection_id、messaging_profile_id、billing_group_id;查询订单状态 client.numberOrders.retrieve()(GET /number_orders/{number_order_id})。此外还提供预订、评论、覆盖范围、客户服务记录、号码块订单等操作,具体参数与响应字段需参考 api-details.md。
使用限制:电话号码须使用 E.164 格式(如 +13125550001),包含加号与国家代码,不可含空格、破折号或括号。列表方法返回自动分页迭代器,可用 for await 遍历。所有 API 调用可能失败,需处理网络错误、401、403、404、422、429 等错误,429 时应按 retry-after 退避重试。不要自行编造参数、枚举或响应字段。