使用Postman调用OptVerse

前提条件

使用OptVerse服务之前，必须先申请华为云账号并进行实名认证。通过此账号，您可以使用所有华为云服务，并且只需为您所使用的服务付费。具体申请信息请见账号注册和实名认证。

使用Postman调用OptVerse服务的具体步骤如下：

步骤1：申请服务：用户在OptVerse管理控制台页面“服务列表”栏选择二维切割服务申请开通。

步骤2：配置环境：下载并安装Postman环境。

步骤3：调用服务：使用Postman调用API接口，查看返回结果或状态码与错误码。

步骤1：申请服务

1. 登录

   a. 使用Chrome浏览器访问系统，打开登录页面。

   图1 登录页
   

   b. 输入华为云账号，用户名和密码 ，点击“登录”按钮， 登录成功后，进入OptVerse首页界面，如下图所示：

   图2 OptVerse首页

   

2. 购买服务

   在使用OptVerse服务之前，用户需要先购买算法服务，OptVerse提供“包年/包月”和“按需”两种计费模式以满足不同场景下的用户需求。购买流程可参考购买服务

3. 创建/授权子账号

   用户可以通过给子账号分配按需开通或已购买的服务并发数来管理资源，子账号的创建及授权可参考创建/授权子账号

4. 获取ProjectId

   a. 调用服务需要获取用户所在节点的ProjectId，鼠标移动至右上角用户名处，之后在弹框中选在我的凭证跳转至用户API凭证页，复制用户所需项目的ProjectId，如下图所示：

   图3 基本信息

   

   图4 项目列表
   

步骤2：配置环境

1. 下载Postman并安装。

   进入https://www.getpostman.com/downloads/，选择合适的版本进行下载安装。

   

   最新版本的Postman需要注册账号并登录后才可以使用。

2. 下载华为云OptVerse服务Postman的Collection文件。

   Collection配置文件下载地址：当前请联系天筹服务侧提供。

3. 加载华为云OptVerse服务Postman的Collection文件。
   1. 登录Postman，单击左上角“file > Import > Import File > Choose File”。
   2. 选择下载的OptVerse.postman_collection.json配置文件。
      图5 加载Collection文件
      
   3. 加载结束后，在左侧导航栏中会显示如下配置文件。

      

步骤3：调用服务

1. 获取Token。
   1. 单击左侧导航栏“IAM/获取Token”，选中“Body”配置项，填写用户的iam用户名,密码,domain用户名。

      

   2. 单击右上角“Send”按钮发送请求，在返回的请求头中获取Token值。

      

      注：Token作为调用OptVerse服务的临时凭证，有效期为24h

2. 调用二维切割服务。
   1. 单击左侧导航栏“Task/方形件/创建任务”，选中“Headers”配置项，复制获取到的ProjectId值到URL处，复制获取的Token值到“X-Auth-Token”。
      图6 复制Token

      

   2. 单击“Body”，查看已有的简单的输入数据，也可以根据API说明，填入自己的数据。
   3. 单击右上角“Send”按钮发送请求，返回异步计算的任务标识task_id，如图7所示。
      图7 获取task_id
      

      若输入数据错误则会提示错误原因，如图8所示。

      图8 获取task_id失败
      
   4. 单击左侧导航栏“Task/方形件/查询任务”，选中“Headers”配置项，复制获取的Token值到“X-Auth-Token”。
      图9 查询任务
      
   5. 复制步骤c获取的task_id到API路径的末尾，如图7所示。
   6. 单击右上角“Send”按钮发送请求，若计算已完成，则返回任务结果，否则返回任务状态。
      图10 发送请求
      

3. 调用求解器服务。
   1. 单击左侧导航栏“Task/求解器/CreateSolverTask”，选中“Headers”配置项，复制获取到的ProjectId值到URL处，复制获取的Token值到“X-Auth-Token”。
      图11 复制Token
      
   2. 单击“Body”，在input['data']对象内的content参数填入base64文件编码。
      图12 上传文件
      

      

   3. 单击右上角“Send”发送请求，返回异步计算的任务标识task_id。
      图13 获取task_id
      
   4. 若请求失败，则返回错误码及对应的错误信息说明，详细错误码信息请参见《天筹求解器OptVerse常见问题》中的“调用OptVerse的API失败时怎么处理？”
      图14 请求失败
      
   5. 查询求解器任务，单击左侧导航栏“Task/求解器/查询任务”，选中“Headers”配置项，复制Token值到“X-Auth-Token”，复制步骤9获取的task_id到API路径的末尾。
      图15 查询任务
      
   6. 单击右上角“Send”按钮发送请求，返回任务结果：
      图16 获取结果