文档首页/ ISDP/ API参考/ 快速入门
更新时间:2024-04-26 GMT+08:00
分享

快速入门

本节以具体的场景为例,介绍如何调用API。

接口调用流程

接口调用流程如图1所示。

图1 接口调用流程

场景描述

以调用ISDP+的OpenAPI创建任务,新增一个任务为例进行描述。

在创建任务之前,已经获取到任务创景以及执行人信息。

涉及API

当您使用Token认证方式完成认证鉴权时,需要获取ISDP+ Token并在调用接口时增加“Authorization”到业务接口请求消息头中。

具体步骤

  1. 发送“POST https://ISDP+ Endpoint/oauth2/oauth/rest_token”。

    • Token认证,具体操作请参考认证鉴权
    • ISDP+ Endpoint,请参见API接口中API的描述。

  2. 在Request Header中增加“Authorization”和“Content-type”。

    • Content-Type:消息体的类型(格式),请参见API接口中API的描述。
    • Authorization:ISDP+ Token。Token也就是步骤1调用ISDP+ Token接口的响应值“access_token”和“token_type”的组合(token_type access_token)

  3. 在Request Body中传入参数样例:

    POST https://isdpcloud-beta.sd.huawei.com/openapi/v1/openSceneTask/createTask
    Authorization: bearer XXXXXXXXXXXXXX
    Content-Type: application/json
    
    {
        "taskQueries": [
            {
                "customerTaskId": "95599",
                "taskName": "客服工单001号",
                "signSiteName": "XX省XX市",
                "sceneName": "质量模板测试",
                "assignedUserType": "1",
                "assignedUser": "13600000001",
                "supplierName": "测试",
                "beginTimestamp": "20220228",
                "endTimestamp": "20220228",
                "taskRemark": "故障描述",
                "taskExtendList": "",
                "address":"故障地址名称",
                "customerName":"用户姓名"
            }
        ]
    }
    

    返回如下响应,表示新增任务成功。响应消息样例如下:

    {
        "stateCode": "0",
        "errorMessage": null,
        "result": [
            {
                "status": "0",
                "message": "保存成功",
                "customerTaskId": "95599",
                "taskId": 131129
            }
        ]
    }

    若请求失败,则会返回错误码及对应的错误信息说明,详细错误码信息请参考错误码

相关文档