对接指引

文档说明

本文档适用于税务智眸合作单位、技术开发对接人员及业务运营人员，旨在清晰阐释 API、SDK 两大集成方式的能力特点与适用边界。可帮助合作方结合自身系统架构、技术储备及业务场景，快速选择最优的集成落地方案，保障对接高效推进。

税务智眸 API、SDK 两类对接方式，统一采用线下商务签约开通模式。企业完成商务合作签约后，由后台管理端统一开放接口调用权限，并分配唯一 AppKey 鉴权凭证。开发团队拿到授权凭证后，即可开展接口联调与正式业务调用。

对接方式	核心定位	底层协议/形态	方案优劣总结
API	标准化 REST 通用接口，提供细粒度、原子化的业务能力调用	HTTP/HTTPS 标准请求协议	兼容性强、拓展自由度高，支持业务侧灵活组合、自定义流程逻辑；需开发人员自主实现请求封装、签名校验等底层逻辑，开发工作量相对较多，适配绝大多数传统业务系统集成场景
SDK	基于原生 API 能力封装的轻量化开发工具包，主打降低开发成本、快速接入	API 上层封装（当前仅支持 Java 技术栈）	完全复用全部接口业务能力，内置网络请求、鉴权处理等底层逻辑，大幅简化开发代码、缩短对接周期；受限于指定编程语言，自定义改造空间弱于原生 API 调用

申请税务智眸开发者权限，获取项目对应的 AppKey、AppSecret 授权参数；

依据平台接口开发规范，完成请求参数组装、签名验证等开发工作，逐一对接调试各项原子业务接口；

完成功能联调后正式部署上线，同步配置异常重试策略、操作日志监控机制，保障服务稳定可用。

查阅官方 SDK 集成文档：https://openapi.qixiangyun.com/doc-2180025
下载对应技术栈 SDK 包，引入项目；
初始化 SDK 并填入鉴权信息；
调用封装好的函数实现业务能力，无需处理 HTTP 底层逻辑。