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

快速入门

本节以具体的场景为例，介绍如何调用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
        }
    ]
}

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

相关文档