dSIPRouter API调用

技能简介

该技能将Postman集合转换为命令行工具，通过curl和jq安全调用dSIPRouter REST API，支持端点组、入站映射、Kamailio重载、CDR查询等操作。

业务背景

运维团队无需编写复杂脚本，即可通过命令行统一管理VoIP核心组件。将Postman集合转化为可复用的CLI工具，大幅降低dSIPRouter API的学习成本，实现端点组、入站映射等关键配置的批量操作与自动化维护。

落地案例：某企业通信管理员需要为新开业的3个分支机构配置SIP中继。传统方式需在Web界面逐条录入，现通过dsiprouter.sh endpointgroups:create批量导入JSON配置，5分钟内完成端点组创建；随后执行kamailio:reload使配置生效，全程无需登录管理后台。日常运维中，还可通过inboundmapping:list快速排查DID路由异常，结合jq过滤定位问题号码。

能做什么

• 管理端点组（列表/创建/更新/删除）
• 配置入站DID映射规则
• 触发Kamailio重载与查看统计
• 处理临时租约授权
• 查询通话详单记录
• 管理运营商组与用户认证

使用说明

1. 安装依赖：确保系统已安装curl和jq
2. 配置环境变量：

   export DSIP_ADDR=your.dsip.host
   export DSIP_TOKEN=your_api_token
   # 如需跳过TLS验证：export DSIP_INSECURE=1

3. 查看可用命令：dsiprouter.sh help
4. 执行API调用示例：

   dsiprouter.sh endpointgroups:list | jq .
   dsiprouter.sh kamailio:reload
   dsiprouter.sh inboundmapping:create --sample | jq .

输入与输出

见下方输入与输出表格。

风险提示

• DSIP_TOKEN泄露可导致VoIP系统被完全控制
• kamailio:reload操作会影响正在进行的通话
• inboundmapping变更可能导致呼叫路由失败
• 生产环境不建议启用DSIP_INSECURE

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/mackhendricks/dsiprouter-skill/SKILL.md
来源类型：GitHub仓库