用途:通过 Telnyx Python SDK 管理账户通知,包括通知渠道、通知配置文件、通知事件与事件条件,以及把渠道、事件条件绑定到具体记录的通知设置,用于接收账户告警与事件。
安装与初始化:安装命令为 pip install telnyx。初始化时从环境变量读取密钥:import os; from telnyx import Telnyx; client = Telnyx(api_key=os.environ.get("TELNYX_API_KEY"))。后续示例默认 client 已初始化。
主要能力:通知渠道支持 channel_type_id 枚举 sms、voice、email、webhook,含 list、create、retrieve、update、delete。创建示例:client.notification_channels.create(channel_type_id="webhook", channel_destination="https://example.com/webhooks")。通知配置文件(notification_profiles)支持增删改查与创建,创建示例传入 name="My Notification Profile"。另有只读列表接口 notification_event_conditions(事件条件)与 notification_events(事件);通知设置 notification_settings 支持 list、create、retrieve、delete,字段含 associated_record_type、notification_channel_id、notification_event_condition_id、notification_profile_id、parameters、status 等。
使用方式:列表方法返回可分页迭代器,可用 for item in page_result 自动遍历全部分页。
错误处理:调用可能遇到网络错误、限流 429、校验错误 422、认证错误 401。代码可捕获 telnyx.APIConnectionError、telnyx.RateLimitError、telnyx.APIStatusError,并按状态码处理;429 时按 Retry-After 头等待重试。常见状态码:401 密钥无效、403 权限不足、404 资源不存在、422 字段格式错误、429 限流。
限制:官方资料未提供收费、价格与配额信息,暂未提供;具体字段取值与回调行为以 Telnyx 官方文档为准。