用途:Telnyx WebRTC - Python 技能用于管理 WebRTC 凭证(On-demand Credentials)和移动推送通知凭证,适合在构建基于浏览器或移动端的软电话应用时使用。
安装与初始化:使用 pip install telnyx 安装;初始化客户端为 client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY")),后续示例均假设 client 已初始化。
主要能力:包括移动推送凭证的列表(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})。
使用方式:通过 client.mobile_push_credentials 和 client.telephony_credentials 调用相应方法;列表方法返回自动分页迭代器,可用 for item in page_result 遍历所有页。
错误处理与限制:所有 API 调用可能因网络错误、速率限制(429)、验证错误(422)或认证错误(401)失败,需在生产代码中处理;常见错误码包括 401 无效 API 密钥、403 权限不足、404 资源未找到、422 验证错误、429 速率限制(建议指数退避重试)。