文档首页/ 云客服/ API参考/ 网页客户端接入/ 更多接口参考/ 根据账户查询客户信息(chat_itau_contas)
更新时间:2025-03-07 GMT+08:00

根据账户查询客户信息(chat_itau_contas)

场景描述

根据账户查询客户信息。

接口方法

POST

接口URI

https://域名/apiaccess/rest/ccmessaging/v1/itau/contas,例如域名是service.besclouds.com

请求说明

表1 请求头参数

序号

名称

参数类型

是否必选

说明

1

x-itau-apikey

string

False

Oauth身份验证生成的client_id,用于授权消费请求应用程序。

2

x-itau-correlationID

string

False

关联标识符用作审计跟踪结构中的组,并允许将在几个不同的应用程序/系统中传递的相同调用关联起来。

3

x-itau-flowID

string

False

流ID

4

userName

string

True

apifabric接口认证用户名

5

password

string

True

apifabric接口认证密码

表2 请求体参数

序号

名称

参数类型

是否必选

说明

1

id_conta

string

True

账户

响应说明

  • 响应状态码: 200
    表3 itau_response_body参数结构

    序号

    名称

    参数类型

    是否必选

    说明

    1.1

    data

    object

    False

    数据

    1.1.1

    id_cliente

    string

    False

    客户端标识

    1.1.2

    nome

    string

    False

    命名

    1.1.3

    telefone

    string

    False

    手机

    1.1.4

    conta_corrente

    string

    False

    接触

    1.1.5

    agencia

    string

    False

    通讯

    1.1.6

    email_gerente

    string

    False

    电子邮件

    1.1.7

    racf_gerente

    string

    False

    管理者

    1.1.8

    funcional_gerente

    string

    False

    功能管理者

    1.1.9

    segmento

    string

    False

    1.1.10

    cod_carteira

    string

    False

    组合

    1.1.11

    plataforma

    string

    False

    平台

    1.1.12

    atendimento_plataforma_digital

    string

    False

    数字平台服务

    1.1.13

    codigo_papel

    string

    False

    纸质代码

    1.1.14

    tipo_estrutura

    string

    False

    结构

    1.1.15

    identificado

    string

    False

    身份证明

  • 响应状态码: 400

    错误的请求:请检查请求路径及参数。

  • 响应状态码: 401

    未授权:1.请确认是否购买了相关服务。2.请联系客服人员检查您账号的当前状态。

  • 响应状态码: 404

    请求的内容未找到:请检查请求的路径。

  • 响应状态码: 500

    业务失败:请依次确认您请求中各参数的取值。

错误码

无。

报文样例

场景描述:根据账户查询客户信息。

URL:https://域名/apiaccess/rest/ccmessaging/v1/itau/contas

请求头:

x-app-key :xxxx
x-itau-apikey : xxx
Content-Type :application/json
userName:xxx
password:xxx

请求参数:

{
    "id_conta": "111"
}

响应参数:

{
    "data": {
        "id_cliente": "string",
        "nome": "string",
        "telefone": "string",
        "conta_corrente": "string",
        "agencia": "string",
        "email_gerente": "string",
        "racf_gerente": "string",
        "funcional_gerente": "string",
        "segmento": "string",
        "cod_carteira": "string",
        "plataforma": "string",
        "atendimento_plataforma_digital": "string",
        "codigo_papel": "string",
        "tipo_estrutura": "string",
        "identificado": "string"
    }
}