API调用详解

预计阅读时间: 3 分钟

瑞宏网的接口都遵循相同接口调用及处理方法

调用方式

企业通过调用电子发票服务平台的接口API来实现发票业务处理。接口API通过HTTPS通道以POST方式调用。请求方发送公共参数和JSON格式的请求报文至服务端,服务端返回JSON格式的响应报文至请求方。

注意

服务端只接受Content-Type="application/json;charset=UTF-8"的请求。

接口URL

请查看各个接口的接口URL,通常各个接口都提供测试和生产两个地址。

测试接口URL:https://www.chinaeinv.com:943/**

生产接口URL:https://www.chinaeinv.com/**

请求参数

需要传递的参数包含公共参数和方法的请求报文两部分:

1、公共参数以URL参数的形式传递,均需要URL Encode,详见下表:

名称 说明
appCode 由电子发票平台分配的appCode
cmdName 方法名称,标示不同的操作请求,具体参见各个接口的详细内容。
sign 数字签名字符串,调用方需要使用电子发票服务平台提供的数字证书对请求报文进行签名并作Base64编码,生成数字签名字符串。

例如 https://www.chinaeinv.com/**?appCode=XXX&cmdName=XXX$sign=XXX

2、方法的请求报文为JSON格式,放置于请求body中。各方法的请求报文不同,字段定义详见各个接口的报文定义。

API调用