http://127.0.0.1:9880/api/
客户端启动后就在本机监听 9880;同一台机器、同一个局域网都能访问。
不收接口授权费,不按调用量计费,也不限制你自己写的程序数量。
商品、订单、库存、会员、采购、促销、门店、报表、外设、支付、小程序。
你的程序只走 HTTP 接口,碰不到引擎和数据;它崩了也不影响收银台。
Python 还是 C#?桌面还是网页?SQLite 还是 MySQL?每个问题 AI 都答得对,拼在一起却互相打架。
库存流水怎么走、红冲跨月怎么记、同一个商品五个价卖给谁、两台机同时卖最后一件谁赢——AI 能编一张表,编不出规则。
跑起来只是开始,一用就错、一错就改,改到地基歪掉。真正贵的是没人给你兜底的试错。所以你缺的不是代码,是底座。
收银、库存、单据、会员、报表、采购、批发、促销、外设、支付都在里面跑了好几年,规则是踩出来的,不是编出来的。
你在外面写网页、写小程序、写 App、接硬件,调的都是同一套接口、同一份数据,不需要碰引擎内部。
单机装在本店,商品、会员、流水都在自己硬盘上,不用把经营数据交给任何云平台。
你的程序在底座外面跑:写得好是加分,写坏了删掉重来,收银台和账目一点都不受影响。
浏览器里重新做一个后台,功能自己定,界面自己画。
老板看报表、店员查库存、顾客查订单,都能自己做前端。
给批发客户、加盟店做一个只能下单的入口,订单直接进门店。
把平台订单拉进门店,省掉手工录单。
称重商品直接进购物车,小票模板自己排版。
会员到店刷脸,自动核销、自动记积分。
每天定时导出对账单,发到财务的邮箱或群里。
从别的系统一次性导商品、会员、期初库存。
Windows 客户端装好、登录主收银,引擎就在本机 9880 端口上跑起来了。
用系统里的账号调登录接口,返回 sessionToken;网页后台类的程序,请求时放在 X-Office-Session 头里。
curl -X POST http://127.0.0.1:9880/api/auth/login -H "Content-Type: application/json" -d "{\"username\":\"admin\",\"password\":\"你的密码\"}"
都是 JSON 进、JSON 出。比如读商品列表、看看板数据:
curl "http://127.0.0.1:9880/api/products"
curl "http://127.0.0.1:9880/api/dashboard"
把接口清单丢给任意 AI 编程工具,说清你要什么界面,它会自己查接口、写页面、联调。清单里每个接口都带分组、参数和示例。
这是海蝶CyberPOS 的接口清单(207 个,JSON 格式)。
帮我做一个网页后台,先做两页:
1. 商品列表,支持按名称/条码搜索,能改零售价;
2. 今日营业概览,显示单数、金额、客单价。
只调用清单里已有的接口,登录用 /api/auth/login。
把地址里的 127.0.0.1 换成收银机的内网 IP,比如 192.168.1.20:9880,同一网段就能连。
用我们的中转服务,或者用花生壳这类内网穿透工具把 9880 映射出去,费用交给服务商。
X-Timestamp、X-Client-Id、X-Signature 三个头,防止别人伪造请求。