全部 Skill/纷享销客 CRM 开放平台

纷享销客 CRM 开放平台 Skill

纷享销客的 OpenAPI 用一套对象接口读写客户、线索、商机和自定义对象，但新旧两代传参、预置与 __c 对象的两套路径、offset 上限这些细节很容易写错。这份 skill 按开发者要做的事整理成 8 个能力域，并标出了文档自相矛盾、以及经无凭证探测证实写错的地方。

文档版 · 未实测fxiaokeopen.fxiaoke.comBearer accessToken + x-fs-ea 请求头CRM更新 2026-09-11
8份 reference
7个易错点
5条无凭证探测
2026-09-11文档抓取
INSTALL · 安装

安装

选你用的 Agent，复制命令。

npx -y skills add fxp/skillify --skill fxiaoke --agent claude-code --yes

装到项目的 .claude/skills/；加 -g 装到全局。装完需要你手动执行 /reload-plugins，这一步 Agent 代劳不了。

或者让 Agent 自己装

读 https://github.com/fxp/skillify/blob/main/skills/fxiaoke/prompt.md 并照它执行
下载 fxiaoke.skill 53 KB 源文件 ↗

装对了的标志：references/ 下有 8 份文档，里面 grep '<!-- Gap:' 能搜到 3 处。

TRY ASKING · 装好后可以这样问

装好后，可以这样问你的 Agent

这份 Skill 覆盖的典型任务。点一下复制。

CAPABILITIES · 能力清单

8 类能力

每类能力对应一份 reference，Agent 按任务只打开需要的那份。

鉴权与公共参数

客户端凭证 / 授权码 / 旧版 corpAccessToken、新旧两代 header 与 body、所在云域名、thirdTraceId

references/auth.mdPOST /oauth2.0/token · GET /oauth2.0/authorize · POST /cgi/corpAccessToken/get/V2

对象与字段

对象列表与字段描述、预置与 __c 的 apiName 规则、按字段类型填值、上传附件拿 npath

references/objects-and-fields.mdPOST /cgi/crm/v2/object/list · POST /cgi/crm/v2/object/describe · POST /cgi/crm/v2/generatorFileUploadCredential

查询条件与分页

search_query_info 结构、operator 全表、limit / offset 规则、_id 游标深翻页、总数参数

references/query-and-paging.mdPOST /cgi/crm/v2/data/query · POST /cgi/crm/custom/v2/data/findSimple

客户 / 线索 / 商机

预置对象增删改查、作废与删除、变更负责人、公海与线索池、相关团队、锁定

references/crm-preset-objects.mdPOST /cgi/crm/v2/data/create · POST /cgi/crm/v2/data/update · POST /cgi/crm/v2/data/changeOwner · POST /cgi/crm/v2/data/choose

自定义对象

__c 对象的专用路径、单条与批量作废、v1 到 v2 参数名变化

references/custom-objects.mdPOST /cgi/crm/custom/v2/data/create · POST /cgi/crm/custom/v2/data/query · POST /cgi/crm/custom/data/invalid

通讯录

部门下成员、部门与人员对象、用户组、角色、人员对象的数据权限

references/org-directory.mdPOST /cgi/user/list · POST /cgi/user/simpleList · POST /cgi/crm/v2/special/usergroupList

消息推送

文本 / 卡片 / 图文企信消息、服务号撤回、ERP 数据推送；事件回调无公开文档

references/messaging.mdPOST /cgi/message/send · POST /cgi/app/message/revoke · POST /cgi/crm/erp/syncdata/objdata/push

错误码与限流

判错方式、探测到的真实错误、全局返回码、100 次每 20 秒与每日配额、权限类报错排查

references/errors-and-limits.mdGlobal · 100 calls / 20 s per API
FACTS · 当前事实

当前事实

整理自官方文档（抓取于 2026-09-11），还没有用真实凭证验证。

项值
Base URLhttps://open.fxiaoke.com（纷享云）；其他云用 open-hwcloud.fxiaoke.com 等，不是 www.fxiaoke.com
换 tokenPOST /oauth2.0/token，grantType=app_secret；7200 秒，0–6600 秒内返回同一个，每分钟 ≤10 次且不能并发
每个请求POST + JSON，URL 带新的 thirdTraceId（UUID v4）；出错也是 HTTP 200，判 errorCode
最易选错预置对象走 /cgi/crm/v2/data/*，__c 自定义对象走 /cgi/crm/custom/v2/data/*
分页limit ≤100，offset 为 limit 整数倍且 ≤10000，超出用 _id 游标
GOTCHAS · 易错点

照通用经验写容易错的 7 件事

来自官方文档，还没有用真实凭证验证。

  1. 新旧两代传参不能混用。新版 token 放 authorization: Bearer、操作人放 x-fs-userid（员工 ID）；旧版在 body 放 corpAccessToken / corpId / currentOpenUserId。
  2. 自定义对象是另一套路径。apiName 以 __c 结尾的对象走 /cgi/crm/custom/v2/data/*，创建时 dataObjectApiName 放在 data.object_data 里。
  3. offset 有 10000 的上限。全量同步要按 _id 升序、_id GT 上一页最后一条、offset 固定 0 翻页。
  4. 字段值类型反直觉。金额和数字传字符串，日期传毫秒时间戳，单选传 option 的 value，员工字段即使单选也是列表。
  5. 删除要先作废，负责人只能 changeOwner。公海和线索池里的数据要先 choose 领取，否则谁都没有权限。
  6. 写入默认触发审批流和工作流。批量导入要显式传 triggerApprovalFlow: false。
  7. 错误码表和实际返回对不上。探测到 appSecret 错误回 10006、缺鉴权回 20017，都和文档码表的含义不同；只信 0 与 20016。
STATUS · 验证状态

验证状态

文档版：整理自官方文档（抓取于 2026-09-11），还没有用真实凭证调用验证。页面和 Skill 里标「文档原文，未实测」的报错与行为都来自文档本身。

无凭证探测

  • 所有错误（缺参数、伪造凭证、缺鉴权）都返回 HTTP 200，错误只在 body 的 errorCode 里
  • 新版 /oauth2.0/token 与旧版 /cgi/corpAccessToken/get/V2 都在服务；appSecret 伪造或缺失都回 errorCode 10006，而文档码表里 10006 是「缺少参数scope」
  • 业务接口完全不带鉴权返回 errorCode 20017 和「corpAccessToken为必填项」，码表里 20017 是 corpId 未找到
  • 新版 header 传参与旧版 body 传参网关都识别，伪造 token 均返回 20016
  • 文档示例里的 www.fxiaoke.com/cgi/... 返回 302 HTML，不是 API 网关；open-hwcloud.fxiaoke.com 可达且行为一致
有这个平台的沙箱或 API Key？联系我们——补测并做完装与不装的对照测试后，它会升级为「已实测」。