API开放平台

TIP

# 信用额度接口

# 信用额度新增接口

接口说明： 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window) 3、部分预置字段的特殊逻辑，参考 fields特殊参数说明

请求方式： POST（HTTPS）
**请求地址： ** https://openapi.qince.com/api/ig/v1/credibilityQuotaAdd/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "fields": {
    "cm_id": "6928823652322085688",
    "credibility_type": "1",
    "credibility_amount": "20",
    "valid_start_date": "2025-12-01",
    "valid_end_date": "2025-12-12",
    "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
  },
  "is_trigger": false,
  "check_rule": false
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
fields VARCHAR 是 JSON格式字符串。格式：{字段key:value}，
(非特殊字段数据格式参见附录六)
is_trigger boolean 否 是否触发工作流；true:触发，false:不触发
trigger_employee VARCHAR(32) 否 是否触发工作流为true的时候必填，员工id
check_rule boolean 否 是否校验验证规则和查重规则；true:校验，false:不校验

fields特殊参数说明：

字段名称 字段key 字段类型 必填 特殊说明
客户 cm_id 客户 是 系统客户id
信用类型 credibility_type 单选 是 信用类型 1正式额度 2 临时额度
信用额度 credibility_amount 金额 是 信用额度金额
有效开始日期 valid_start_date 日期 是 日期格式 正式额度类型不传
有效结束日期 valid_end_date 日期 是 日期格式 正式额度类型不传
币种 currency_type 单选框 否 未开启多币种时，不需要传，无论币种字段传入什么值均不接收；
开启多币种后，币种字段不传默认为本位币，传值取传入的值；

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": "",
  "response_data": "6066483328179541690"
}

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "保存失败！"
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
return_data String

# 信用额度更新接口

接口说明： 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、详细字段入参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window) 3、部分预置字段的特殊逻辑，参考 fields特殊参数说明

请求方式： POST（HTTPS）
**请求地址： ** https://openapi.qince.com/api/ig/v1/credibilityQuotaEdit/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "data_id": "6928823652322085688",
  "fields": {
    "cm_id": "6928823652322085688",
    "credibility_type": "1",
    "credibility_amount": "20",
    "valid_start_date": "2025-12-01",
    "valid_end_date": "2025-12-12",
    "fieldKey(自定义字段key)": "fieldValue(数据格式参见附录六)"
  },
  "is_trigger": false,
  "check_rule": false
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
data_id VARCHAR 是 数据id
fields VARCHAR 是 JSON格式字符串。格式：{字段key:value}，
(非特殊字段数据格式参见附录六)
is_trigger boolean 否 是否触发工作流；true:触发，false:不触发
trigger_employee VARCHAR(32) 否 是否触发工作流为true的时候必填，员工id
check_rule boolean 否 是否校验验证规则和查重规则；true:校验，false:不校验

fields特殊参数说明：

字段名称 字段key 字段类型 必填 特殊说明
客户 cm_id 客户 是 系统客户id
信用类型 credibility_type 单选 是 信用类型 1正式额度 2 临时额度
信用额度 credibility_amount 金额 是 信用额度金额
有效开始日期 valid_start_date 日期 是 日期格式 正式额度类型不传
有效结束日期 valid_end_date 日期 是 日期格式 正式额度类型不传
币种 currency_type 单选框 否 未开启多币种时，不需要传，无论币种字段传入什么值均不接收；
开启多币种后，币种字段不传默认为本位币，传值取传入的值；

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": "",
  "response_data": "6066483328179541690"
}

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "保存失败！"
}

参数说明：

参数 类型 说明
msg_id String 请求消息ID
return_code int 响应编码。0：成功，1：失败。其他详见附录错误码说明 (opens new window)
return_msg String 响应说明
return_data String

# 查询信用额度

接口说明 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符，详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)

请求方式： POST（HTTPS）
**请求地址： ** https://openapi.qince.com/api/ig/v1/credibilityQuotaQuery/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "page": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "name",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "field_xjcv4__c",
          "operator": "NQ",
          "field_values": [
            "1"
          ]
        }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page INT 是 页数，默认值为1
rows INT 是 条数，默认值为100
sorts List 是 排序，默认按创建时间倒序排序
sorts.field_key VARCHAR(30) 是 排序字段
sorts.type VARCHAR(4) 是 排序类型：asc 正序，desc 倒序
query_group List 是 查询条件列表
query_group.connector List 是 组内查询条件，条件AND或OR
query_group.filters VARCHAR(4) 是 组内查询条件
query_group.filters.field_key VARCHAR(32) 是 字段key
query_group.filters.operator VARCHAR(10) 是 操作符，详见附录操作符说明 (opens new window)
query_group.filters.field_values List 是 字段值集合

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": "",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-12-11 19:44:39"
    },
    "credibility_amount": "100.00",
    "modifyier_id": {
      "name": "夏亚琼",
      "id": "7397783875201961331",
      "status": "1"
    },
    "business_type": {
      "code": "busitype_default__c",
      "id": "6367444428270883421",
      "label": "默认业务类型",
      "status": "1"
    },
    "id": "8227945601017361914",
    "department": {
      "name": "igcpq",
      "id": "10",
      "status": "1"
    },
    "valid_status": {
      "code": "2",
      "label": "生效中"
    },
    "owner": {
      "name": "夏亚琼",
      "id": "7397783875201961331",
      "status": "1"
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-12-11 19:44:39"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "valid_start_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-12-01"
    },
    "valid_end_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-12-31"
    },
    "cm_id": {
      "objectKey": "bas_cm_customer",
      "name": "客户004",
      "objectName": "客户",
      "id": "5394222280853084452",
      "status": "1"
    },
    "name": "CA2025121100004",
    "creator_id": {
      "name": "夏亚琼",
      "id": "7397783875201961331",
      "status": "1"
    },
    "credibility_type": {
      "code": "2",
      "label": "临时信用"
    },
    "status": {
      "code": "NORMAL",
      "label": "正常"
    }
  }
]

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "查询失败！"
}

# 推送信用额度

推送说明：参见 推送aPaaS对象数据变更 (opens new window) 请求示例：

{
  "appId": 200004,
  "data": {
    "objectKey": "dms_cm_credibility_quota",
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-12-11 19:44:39"
    },
    "credibility_amount": "100.00",
    "modifyier_id": {
      "name": "夏亚琼",
      "id": "7397783875201961331",
      "status": "1"
    },
    "business_type": {
      "code": "busitype_default__c",
      "id": "6367444428270883421",
      "label": "默认业务类型",
      "status": "1"
    },
    "id": "8227945601017361914",
    "department": {
      "name": "igcpq",
      "id": "10",
      "status": "1"
    },
    "valid_status": {
      "code": "2",
      "label": "生效中"
    },
    "owner": {
      "name": "夏亚琼",
      "id": "7397783875201961331",
      "status": "1"
    },
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-12-11 19:44:39"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "valid_start_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-12-01"
    },
    "valid_end_date": {
      "format": "YYYY-MM-DD",
      "value": "2025-12-31"
    },
    "cm_id": {
      "objectKey": "bas_cm_customer",
      "name": "客户004",
      "objectName": "客户",
      "id": "5394222280853084452",
      "status": "1"
    },
    "name": "CA2025121100004",
    "creator_id": {
      "name": "夏亚琼",
      "id": "7397783875201961331",
      "status": "1"
    },
    "credibility_type": {
      "code": "2",
      "label": "临时信用"
    },
    "status": {
      "code": "NORMAL",
      "label": "正常"
    }
  },
  "dataFormat": "json",
  "dataId": "7203809467203730246",
  "dataSource": "biz",
  "dataType": "apaas_data_change_event",
  "tenantId": 5457613360890366827,
  "version": "v1"
}

# 客户余额查询

接口说明 1、通过查询对象配置 (opens new window)接口，获得对象对应的fieldList --> 字段列表结构信息 2、请求入参操作符，详见附录操作符说明 (opens new window) 3、字段出参规范说明参见 附录六：aPaaS字段类型样式说明 (opens new window)

请求方式： POST（HTTPS）
**请求地址： ** https://openapi.qince.com/api/ig/v1/cmBalanceQuery/{ openid }/{ timestamp }/{ digest }/{ msg_id } 在线调试
请求示例：

{
  "page": "1",
  "rows": "100",
  "sorts": [
    {
      "field_key": "create_time",
      "type": "desc"
    }
  ],
  "query_group": [
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "name",
          "operator": "ISN"
        }
      ]
    },
    {
      "connector": "OR",
      "filters": [
        {
          "field_key": "field_xjcv4__c",
          "operator": "NQ",
          "field_values": [
            "1"
          ]
        }
      ]
    }
  ]
}
说明： 本示例仅供参考，具体以参数说明为准。

参数说明：

参数 类型 必填 说明
page INT 是 页数，默认值为1
rows INT 是 条数，默认值为100
sorts List 是 排序，默认按创建时间倒序排序
sorts.field_key VARCHAR(30) 是 排序字段
sorts.type VARCHAR(4) 是 排序类型：asc 正序，desc 倒序
query_group List 是 查询条件列表
query_group.connector List 是 组内查询条件，条件AND或OR
query_group.filters VARCHAR(4) 是 组内查询条件
query_group.filters.field_key VARCHAR(32) 是 字段key
query_group.filters.operator VARCHAR(10) 是 操作符，详见附录操作符说明 (opens new window)
query_group.filters.field_values List 是 字段值集合

响应示例：

{
  "msg_id": "X000001",
  "return_code": 0,
  "return_msg": "",
  "response_data": "<<DATA>>"
}

数据DATA示例:

[
  {
    "lock_status": {
      "code": "UNLOCK",
      "label": "未锁定"
    },
    "create_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-12-11 19:44:39"
    },
    "approval_status": {
      "code": "APPROVED",
      "label": "已通过"
    },
    "modify_time": {
      "format": "YYYY-MM-DD HH:mm:ss",
      "value": "2025-12-11 19:44:39"
    },
    "wait_balance": "0.00",
    "credit_amount": "2100.00",
    "source_type": {
      "code": "LROPFXCJ",
      "label": "自建"
    },
    "prestore_amount": "0.00",
    "wait_sentamount": "0.00",
    "cm_id": {
      "objectKey": "bas_cm_customer",
      "name": "客户004",
      "objectName": "客户",
      "id": "5394222280853084452",
      "status": "1"
    },
    "modifyier_id": {
      "name": "夏亚琼",
      "id": "7397783875201961331",
      "status": "1"
    },
    "business_type": {
      "code": "busitype_default__c",
      "id": "5923897985416087869",
      "label": "默认业务类型",
      "status": "1"
    },
    "name": "2025121100013",
    "creator_id": {
      "name": "夏亚琼",
      "id": "7397783875201961331",
      "status": "1"
    },
    "id": "6547630871801109305",
    "status": {
      "code": "NORMAL",
      "label": "正常"
    }
  }
]

异常示例：

{
  "msg_id": "X000001",
  "return_code": 1,
  "return_msg": "查询失败！"
}

← mbo设置查询接口 →