用途:该技能面向使用 Ruby 构建浏览器或移动端软电话(softphone)应用的场景,通过 telnyx Ruby SDK 管理 WebRTC 相关的电话凭证(telephony credentials)和移动推送通知凭证(mobile push credentials)。
主要能力:
- 移动推送凭证:列出(GET /mobile_push_credentials)、创建(POST /mobile_push_credentials,必填 type、certificate、private_key、alias)、检索(GET /mobile_push_credentials/{push_credential_id})、删除(DELETE /mobile_push_credentials/{push_credential_id})。
- 电话凭证:列出(GET /telephony_credentials)、创建(POST /telephony_credentials,必填 connection_id,可选 expires_at、name、tag)、获取(GET /telephony_credentials/{id})、更新(PATCH /telephony_credentials/{id},可选 connection_id、expires_at、name、tag)、删除(DELETE /telephony_credentials/{id})。
使用方式: 先安装并初始化客户端:
gem install telnyx
require "telnyx" client = Telnyx::Client.new( api_key: ENV["TELNYX_API_KEY"], )
随后调用相应资源方法,例如列表 client.telephony_credentials.list,创建 client.telephony_credentials.create(connection_id: "1234567890"),检索 client.mobile_push_credentials.retrieve("...") 等。分页可用 page.auto_paging_each { |item| puts item.id }。
错误处理:API 调用可能返回网络错误、429 限流、422 校验错误或 401 认证错误,资料建议在生产代码中捕获 Telnyx::Errors::APIConnectionError、RateLimitError、APIStatusError 等,并对 429 采用指数退避重试。常见状态码:401 密钥无效,403 权限不足,404 资源不存在,422 校验失败,429 被限流。
适用场景:需要在 Ruby 后端为 WebRTC 软电话申请、轮换或撤销 SIP/电话凭证,以及配置 iOS 等平台的移动推送证书与私钥。
限制:资料仅覆盖凭证与推送凭证的接口,未说明 WebRTC 媒体连接、通话控制或价格等细节,这些暂未提供。