2.1 相对方批量查询 - 甄零开放平台

请求参数

Query 参数

domain

enum<string>

必需

固定值，表示相对方查询API

枚举值:

TRADING

示例值:

TRADING

Header 参数

Content-Type

string

可选

示例值:

application/json

Authorization

string

可选

默认值:

Body 参数application/json

page

integer

必需

size

integer

必需

startTime

string

相对方最后更新时间从

必需

格式：yyyy-MM-dd HH:mm:ss

endTime

string

相对方最后更新时间至

必需

格式：yyyy-MM-dd HH:mm:ss

showTrading

boolean

是否查询相对方银行列表，默认false

必需

showBank

boolean

是否查询相对方行表

必需

condition

object

动态查询条件，默认为模糊查询.

可选

格式：字段@条件，查询条件支持：
@EQUAL 等于
@FULLY_FUZZY 全模糊
@BEFORE_FUZZY 前模糊
@AFTER_FUZZY 后模糊

partyName

string

可选

certificateNumber@@EQUAL

string

可选

示例

{
    "page": 1,
    "size": 10,
    "startTime": "2025-01-01 00:00:00",
    "endTime": "2025-12-31 23:59:59",
    "showTrading": false,
    "showBank": false,
    "condition": {
        "partyName": "上海甄零科技有限公司",
        "certificateNumber@@EQUAL": "91310115MA1K4PGE3T"
    }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2p/rest/invoke/SFpFUk86T1JDSEVTVFJBVElPTjpISVRGLkFQSS5EQVRBX1FVRVJZ?domain=TRADING' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 1,
    "size": 10,
    "startTime": "2025-01-01 00:00:00",
    "endTime": "2025-12-31 23:59:59",
    "showTrading": false,
    "showBank": false,
    "condition": {
        "partyName": "上海甄零科技有限公司",
        "certificateNumber@@EQUAL": "91310115MA1K4PGE3T"
    }
}'

返回响应

🟢200成功

application/json

Body

object {0}

示例

{
    "message": "execute success",
    "result": {
        "errcode": "0",
        "errmsg": "ok",
        "data": {
            "totalPages": 1,
            "page": 1,
            "size": 1,
            "content": [
                {
                    "sourceKey": "91310115MA1K4PGE3T",
                    "upSystemId": "",
                    "objectVersionNumber": "2",
                    "partyImportanceCode": "",
                    "insideOutside": "L",
                    "lastUpdateDate": "2025-04-03 16:59:13",
                    "customerSupplier": "W",
                    "uuid": "d7c25499bcb041eca3b4054a97f63c52",
                    "companyProperty": "",
                    "partyShortName": "上海甄零",
                    "partyLabel": "",
                    "mainPartyId": "9899259",
                    "legalPerson": "谢伟虎",
                    "partyName": "上海甄零科技有限公司",
                    "id": "12555621",
                    "sourceUpSystemFlag": false,
                    "partyId": "12555621",
                    "approvalStatus": "APPROVED",
                    "lastUpdatedBy": "0",
                    "address": "中国（上海）自由贸易试验区春芳路400号1幢3层",
                    "isAutomaticSign": "0",
                    "accountType": "COMPANY",
                    "validSupplier": false,
                    "creationDate": "2025-04-03 16:59:13",
                    "checkFlag": false,
                    "companyId": "12555621",
                    "legalCertificateNumber": "",
                    "certificateNumber": "91310115MA1K4PGE3T",
                    "createdBy": "0",
                    "tenantId": "1273",
                    "mdmBpCode": "",
                    "partyNumber": "91310115MA1K4PGE3T",
                    "validCustomer": false,
                    "startDate": "2024-01-01 00:00:00",
                    "certificateType": "11"
                }
            ],
            "totalElements": "1"
        }
    },
    "success": true
}