企业信息获取接口 - 开放平台API

请求参数

Header 参数

Content-Type

string

可选

示例值:

application/json

Body 参数application/json

authorize

object

安全凭证

必需

appSecId

string

密钥ID

必需

平台随机生成

appSec

string

签名串

必需

根据密钥ID和KEY生成的签名串

globalInfo

object

接口信息

必需

appId

string

接口ID

必需

例：QYXX

version

string

接口版本号

必需

例：V1.0

interfaceCode

string

接口编码

必需

例：ENTERPRISE.GET

enterpriseCode

string

企业编码

必需

dataExchangeId

string

接口数据加密

必需

例：默认值dataExchangeId

data

object

获取条件参数

必需

由获取条件参数通过用Base64加密生成的字符串

page

integer

当前第几页

必需

默认从1开始

pageSize

integer

页数

必需

默认10条

nsrmc

string

企业名称

可选

与企业税号必填一项

nsrdjNo

string

企业税号

可选

与企业名称必填一项

示例

{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9CF3C47E4F9837C99",
        "appSec": "SRO44E5KT8b/SLr7rn7dfHsv5gM="
    },
    "globalInfo": {
        "appId": "QYXX",
        "version": "V1.0",
        "interfaceCode": "ENTERPRISE.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJwYWdlIjoxLCJwYWdlU2l6ZSI6MTAsIm5zcm1jIjoi6KW/5a6J5bu6562R56eR5oqA5aSn5a2mIiwibnNyZGpObyI6IiJ9"
}

//data 解密请求参数
{
    "page": 1,
    "pageSize": 10,
    "nsrmc": "西安建筑科技大学",
    "nsrdjNo": ""
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'http://117.78.0.163/51GP/post/rest/enterprise/dii' \
--header 'Content-Type: application/json' \
--data-raw '{
    "authorize": {
        "appSecId": "2AE5415E6FBD2BE9CF3C47E4F9837C99",
        "appSec": "SRO44E5KT8b/SLr7rn7dfHsv5gM="
    },
    "globalInfo": {
        "appId": "QYXX",
        "version": "V1.0",
        "interfaceCode": "ENTERPRISE.GET",
        "enterpriseCode": "TEST",
        "dataExchangeId": "dataExchangeId"
    },
    "data": "eyJwYWdlIjoxLCJwYWdlU2l6ZSI6MTAsIm5zcm1jIjoi6KW/5a6J5bu6562R56eR5oqA5aSn5a2mIiwibnNyZGpObyI6IiJ9"
}

//data 解密请求参数
{
    "page": 1,
    "pageSize": 10,
    "nsrmc": "西安建筑科技大学",
    "nsrdjNo": ""
}'

返回响应

🟢200成功

application/json

Body

data

object

返回参数

必需

由返回的参数通过用Base64加密生成的字符串

result

array [object {15}]

发票数据

必需

totalRows

integer

数据的总条数

必需

returnStateInfo

object

接口状态信息

必需

returnCode

string

返回状态编码

必需

例：0000

returnMessage

string

返回信息

必需

例：处理成功

示例

{
    "data": "eyJyZXN1bHQiOlt7ImFjY05vIjoiMzcwMDAyMzAwOTAyNjQwMDYzOSIsImNsRGF0ZSI6bnVsbCwia2hoIjoi5bel6KGM6KW/5a6J6ZuB5aGU6Lev5pSv6KGMIiwibHhkaCI6IjAyOS04MjIwMjIzMSIsImx4ciI6bnVsbCwibm90ZSI6bnVsbCwibnNoeHlkbSI6IjEyNjEwMDAwNDM1MjMxMDZYQiIsIm5zcmRqTm8iOiIxMjYxMDAwMDQzNTIzMTA2WEIiLCJuc3JtYyI6Iuilv+WuieW7uuetkeenkeaKgOWkp+WtpiIsIm5zcnh5ZGoiOm51bGwsIm56Y2giOm51bGwsInJuIjoxLCJzY2p5ZHoiOm51bGwsInlqZHoiOm51bGwsInpjZHoiOiLopb/lronluILpm4HloZTot6/kuK3mrrUxM+WPtyJ9XSwidG90YWxSb3dzIjoxfQ==",
    "returnStateInfo": {
        "returnCode": "0000",
        "returnMessage": "处理成功"
    }
}

//data加密前的数据
{
    "result": [
        {
            "accNo": "3700023009026400639",
            "clDate": null,
            "khh": "工行西安雁塔路支行",
            "lxdh": "029-82202231",
            "lxr": null,
            "note": null,
            "nshxydm": "1261000043523106XB",
            "nsrdjNo": "1261000043523106XB",
            "nsrmc": "西安建筑科技大学",
            "nsrxydj": null,
            "nzch": null,
            "rn": 1,
            "scjydz": null,
            "yjdz": null,
            "zcdz": "西安市雁塔路中段13号"
        }
    ],
    "totalRows": 1
}