更新时间:2023-09-20 gmt 08:00

调用api实现功能-凯发k8国际娱乐官网入口

本章节通过postman软件,调用通用图像搜索服务实例的添加数据api,帮助您快速熟悉api的使用方法,具体流程如下:

步骤一:开通服务

步骤二:创建实例

步骤三:配置环境

步骤四:token认证鉴权

步骤五:调用服务

准备工作

已注册华为帐号,并完成实名认证,帐号不能处于欠费或冻结状态。

步骤一:开通服务

服务申请开通您可以按照以下步骤进行操作:

  1. 登录华为云图像搜索服务管理控制台。

    控制台左上角默认显示服务部署在“华北-北京四”区域,请您根据业务需要选择对应区域,各服务部署的区域具体请参见。

  2. 单击页面右上角的“开通服务”按钮,开通图像搜索服务。
    图1 开通服务
  • 服务只需要开通一次即可,后面使用时无需再开通。
  • 整体开通图像搜索服务后,具体的搜索服务实例需要单独创建。

步骤二:创建实例

以创建“通用图像搜索”服务实例为例,具体操作步骤如下:

  1. 在控制台,单击左侧导航栏“实例管理->实例创建”,进入到实例创建页面。
  2. 按图中所示填写参数,其余选项保持默认。

  3. 填写完成后,单击“立即创建”,弹出窗口提示创建成功后,您可以前往“实例概况”查看创建的实例。

如果没有特殊需求,高级设置中的配置项均保持默认值即可。

步骤三:配置环境

下载并安装postman,postman建议使用7.24.0版本。

步骤四:token认证鉴权

token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用api接口时,需要使用token进行鉴权。

  1. 在postman界面,选择new > collection,设置相应的名称并单击“create”完成创建。

  2. 选择创建的collection,单击鼠标右键,选择“add request”,设置request name并单击“save”

  3. 请求方式修改为"post",输入url。

    例如,以cn-north-4为例,url为“https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens”

  4. 在“headers”列表中添加“key”“content-type”“value”“application/json”

  5. 选中“body”的配置项,选中“raw”,在空白处添加以下代码。
    图2 token认证鉴权

    图中代码红框内加粗的蓝色字段需要根据实际值填写,其中username为用户名,domainname为用户所属的账号名称,********为用户登录密码,project name为服务的部署区域,获取方法请登录获取。

    图像搜索服务部署的区域必须与调用的服务所在区域一致,本示例中为cn-north-4。

    { 
         "auth": { 
             "identity": { 
                 "methods": [ 
                     "password" 
                 ], 
                 "password": { 
                     "user": { 
                         "name": "username", 
                         "password": "**********", 
                         "domain": { 
                             "name": "domainname" 
                         } 
                     } 
                 } 
             }, 
             "scope": { 
                 "project": { 
                     "name": "cn-north-4" 
                 } 
             } 
         } 
     }
  6. 单击右上角“send”按钮发送请求。获取返回结果中的token值(token有效期为24小时)。

步骤五:调用服务

向已创建的“通用图像搜索”服务实例中添加数据,可以调用添加数据api实现,搜索数据、检查数据、更新数据、删除数据等操作。具体操作如下:

  1. 新建请求,请求方式为修改“post”,按要求填写url。

    例如:服务部署在“华北-北京四”,添加数据api的请求url为“https://mms.cn-north-4.myhuaweicloud.com/v2/{project_id}/mms/{service_name}/data/add”。

  2. 选中“headers”配置项,复制token值到“x-auth-token”
  3. 登录,查询属于“华北-北京四”的项目id,替换uri中的{project_id}。
  4. 使用已创建的通用图像搜索服务实例名称“imagesearch_test”,替换uri中的{service_name}。

  5. 单击“body”配置项,按照如下图中所示内容填写参数。关于body体中其他参数说明,请参考添加数据api
    图3 body参数
  6. 单击右上角“send”按钮发送请求,查看添加数据结果。
分享:
网站地图