柠檬云通过 HTTPS 协议对外提供 REST 风格的 API 服务。接入方完成商务签约后,将获得接口基础地址(apiHost)及专属的配套凭证,所有接口请求均需基于此地址发起。API 环境说明#
| 环境 | 接口地址 | 说明 |
|---|
| 正式环境 | 由商务团队随凭证一并提供 | 联调与生产共用,需使用真实纳税人账号 |
注意:当前仅开放正式环境,测试时须使用真实有效的纳税人账号。请在联调前与商务确认测试账号已就绪。
地址拼接规则#
接口完整地址 = https://<apiHost> + 接口路径,示例:POST https://<apiHost>/api/v1/open/auth/login
快速验证#
拿到凭证后,可通过以下请求验证网络连通与鉴权是否正常:若返回 access_token 字段,说明对接地址和凭证均已生效。Apifox 调试#
接口规范文件支持导入 Apifox 进行可视化调试,如需获取请联系技术支持。