pachca-api 是即时通讯工具 Пачка 的 REST API 技能入口,供开发者通过 HTTP 接口操作聊天平台资源。
用途:作为选择具体子技能的入口,覆盖消息、聊天、用户、机器人、任务和安全等操作场景。
主要能力(按子技能划分):pachca-profile 获取个人资料、查看我的资料、设置状态;pachca-users 查找员工、创建用户、列出员工;pachca-chats 创建频道、创建会话、创建聊天;pachca-messages 发送消息、回复线程、添加附件;pachca-bots 配置机器人与 Webhook;pachca-forms 显示表单、交互式表单、模态窗口;pachca-tasks 创建任务、列出任务、设置提醒;pachca-search 全文搜索消息;pachca-security 审计、事件日志、安全相关操作。
使用方式:基础地址为 https://api.pachca.com/api/shared/v1,认证使用请求头 Authorization: Bearer <ACCESS_TOKEN>。令牌来源为:机器人令牌在「Автоматизации → Интеграции → API」获取,用户令牌在「Автоматизации → API」获取。若令牌未知,需先向用户确认再执行请求。快速上手步骤为:先获取令牌,再根据任务从子技能表中选择对应技能,然后打开该技能的 SKILL.md 按分步场景执行。数据格式为 JSON,请求头使用 Content-Type: application/json。
限制与注意事项:分页采用基于游标的方式(limit + cursor),而非基于页码;速率限制约为每秒 50 次请求,消息相关操作约为每秒 4 次请求;常见错误包括 422(参数错误)、429(触发速率限制)、403(无访问权限)、404(未找到)。其余功能、收费、平台支持等信息在提供的资料中暂未说明。