联系人
2客户、供应商以及他们所属的细分市场。
联系人联系人细分这里有六件事是真的,而通常不是。
访问基础 URL,API 将返回其自身的目录 — 您的密钥可见的每个模块、其中的每个资源,以及哪些字段可搜索、哪些可筛选。您不需要此页面来编写集成;您需要它来决定是否集成。
应用中的范围、路由和权限标签均从一个列表中生成,因此,除非有相应的后端接口,否则无法提供权限。密钥范围限定为 项目 获取项目——请求工资单会返回403错误,而不是一个空白页面。
搜索, 自, 直至, 跳过 和 获取 在发票和库存变动中含义一致。掌握一次,133 项资源均可依此响应。
每个表都带有一个租户 ID,并且每个查询在到达数据库之前都限定在密钥自己的租户范围内。不存在跨租户读取出错的情况,因为没有参数可以请求这样的读取。
字段列表在启动时从实时模式读取,而非手动维护。新列会自动显示;删除的列绝不会在文档中留下悬空引用,也不会在首次调用时导致500错误。
密钥只读,从不写入。错误的集成不会使发票作废或移动库存。任何更改记录的操作都通过应用或员工登录进行,并归属于个人,记录在审计日志中。
一切皆为 GET 请求。如果您可以使用 curl,您可以使用此功能。
/api/v1密钥可见的完整目录curl https://api.kardopal.com/api/v1 \
-H "X-API-Key: kp_live_…"
/api/v1/me权限探查——这是谁的密钥,能读取什么{
"authType": "api_key",
"tenant": { "name": "Nova Retail", "plan": "pro" },
"scopes": ["items", "sales", "pos"]
}
/api/v1/items?search=lamp&take=2任何资源,统一格式。{
"resource": "items",
"scope": "items",
"total": 41,
"skip": 0,
"take": 2,
"hasMore": true,
"data": [ { "id": "…", "name": "Desk Lamp LED" } ]
}
/api/v1/meta/counts每种资源的行数 — 查看实际存在的数据curl https://api.kardopal.com/api/v1/meta/counts \
-H "X-API-Key: kp_live_…"
| 参数 | 功能 | 备注 |
|---|---|---|
搜索 | 跨资源可搜索字段的不区分大小写匹配。 | 哪些字段已列在 /meta |
自 | 仅从此日期起的记录 | 适用于资源排序的字段 |
直至 | 仅记录截至此日期 | 结合使用 自 针对某个窗口 |
跳过 | 偏移到结果集 | 默认为0 |
获取 | 返回行数 | 默认50,上限200 |
资源也接受对其自身声明字段的精确匹配筛选 — ?status=已支付, ?warehouseId=… — 并且每个都标明了是哪些。每个列表响应都包含 总计 和 更多,因此分页是一个循环,而不是猜测。
29 个模块,129 项资源。每张卡片代表您可以授予密钥的一项权限——灰色标签表示相同记录在您手机应用中的位置。
客户、供应商以及他们所属的细分市场。
联系人联系人细分商品目录:产品、变体、品牌、价格表和单位。
项目类别品牌商品变体价格表单位+1更多仓库、库存水平、库存移动、批次、序列号和货位。
仓库库存移动库存水平批次序列号库存盘点+1更多发票、估价单、订单、贷项通知单及付款。
发票估价单销售订单贷项通知单支付循环发票+1更多收银机、班次、收据、餐桌和每一笔柜台交易。
POS销售POS 班次POS 终端POS用户POS餐桌POS餐桌区域另有5项销售线索、交易、销售漏斗和提案。
销售线索交易业务流程提案采购订单、申请、退货、账单和供应商付款。
采购订单采购请求采购退货账单供应商付款费用、银行账户、交易和税率。
费用费用类别银行账户bank-transactions税率营销活动、收件人、着陆页和表单提交。
营销活动营销活动接收者落地页表单提交人员、部门、请假、工资单、考勤和招聘。
员工部门leave-requests工资单考勤招聘信息另有 2 项时间条目及其对应的项目。
时间记录工时表项目项目、阶段及其相关成本。
项目项目阶段项目成本预约、可预订服务以及提供服务的员工。
预订预订服务预订员工工作、技术人员、工单、合同和设备。
现场工作技术人员服务请求服务合同工单工单+1更多货物、司机、车辆、区域和承运商。
货运司机车辆配送区域承运商工单、SLA 策略、帮助文章与知识库。
订单客户工单帮助文章知识库SLA 政策退货、保修索赔、维修和产品注册。
退货管理保修索赔保修登记维修产品注册可租赁资产、租赁协议及其明细。
资产租赁rental-lines菜单及基于菜单的订单。
菜单项菜单订单票务、服务、柜台、分支机构和显示屏。
排队票排队服务排队计数器队列分支排队显示屏会员、账户、层级、奖励和积分交易。
loyalty-members会员账户忠诚度奖励会员等级忠诚度交易loyalty-coupons站点和分支机构。
地点分支机构设备、站点、盒子、警报、事件和标牌内容。
物联网设备iot-sites物联网警报物联网事件物联网盒子物联网标牌内容生成的资产、包含它们的项目和作业历史。
AI资产AI项目ai-jobs网络成员、报价请求和收款。
网络成员报价请求系列签名请求及收集到的签名。
签名请求签名审批请求及其路由规则。
审批请求审批规则上传文件和扫描文档。
文件扫描文件活动动态、审计日志和通知。
活动审计日志通知这通常是虚假宣传。许多平台都提供广泛的API,然后发布一个只能做三件事的移动应用——审批、查看、通知。Kardopal的应用是产品本身,而非辅助工具:以上所有29个模块都有真实的界面,大部分工作实际上都在手机上完成。
项目。它不需要 hr. 窄密钥故障安全。X-API-Key: kp_live_… — 查询字符串会出现在日志、代理和浏览器历史记录中。