调用api实现功能-凯发k8国际娱乐官网入口
本章节通过postman软件,调用通用图像搜索服务实例的添加数据api,帮助您快速熟悉api的使用方法,具体流程如下:
准备工作
已注册华为帐号,并完成实名认证,帐号不能处于欠费或冻结状态。
步骤一:开通服务
服务申请开通您可以按照以下步骤进行操作:
- 登录华为云图像搜索服务管理控制台。
控制台左上角默认显示服务部署在“华北-北京四”区域,请您根据业务需要选择对应区域,各服务部署的区域具体请参见。
- 单击页面右上角的“开通服务”按钮,开通图像搜索服务。
图1 开通服务
- 服务只需要开通一次即可,后面使用时无需再开通。
- 整体开通图像搜索服务后,具体的搜索服务实例需要单独创建。
步骤二:创建实例
以创建“通用图像搜索”服务实例为例,具体操作步骤如下:
- 在控制台,单击左侧导航栏“实例管理->实例创建”,进入到实例创建页面。
- 按图中所示填写参数,其余选项保持默认。
- 填写完成后,单击“立即创建”,弹出窗口提示创建成功后,您可以前往“实例概况”查看创建的实例。
如果没有特殊需求,高级设置中的配置项均保持默认值即可。
步骤三:配置环境
下载并安装postman,postman建议使用7.24.0版本。
步骤四:token认证鉴权
token是用户的访问令牌,承载了用户的身份、权限等信息,用户调用api接口时,需要使用token进行鉴权。
- 在postman界面,选择“create”完成创建。
- 选择创建的collection,单击鼠标右键,选择“add request”,设置request name并单击“save”。
- 请求方式修改为"post",输入url。
例如,以cn-north-4为例,url为“https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens”。
- 在“headers”列表中添加“key”为“content-type”,“value”为“application/json”。
- 选中“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" } } } }
- 单击右上角“send”按钮发送请求。获取返回结果中的token值(token有效期为24小时)。
步骤五:调用服务
向已创建的“通用图像搜索”服务实例中添加数据,可以调用添加数据api实现,搜索数据、检查数据、更新数据、删除数据等操作。具体操作如下:
- 新建请求,请求方式为修改“post”,按要求填写url。
例如:服务部署在“华北-北京四”,添加数据api的请求url为“https://mms.cn-north-4.myhuaweicloud.com/v2/{project_id}/mms/{service_name}/data/add”。
- 选中“headers”配置项,复制token值到“x-auth-token”。
- 登录,查询属于“华北-北京四”的项目id,替换uri中的{project_id}。
- 使用已创建的通用图像搜索服务实例名称“imagesearch_test”,替换uri中的{service_name}。
- 单击“body”配置项,按照如下图中所示内容填写参数。关于body体中其他参数说明,请参考添加数据api。
图3 body参数
- 单击右上角“send”按钮发送请求,查看添加数据结果。
意见反馈
文档内容是否对您有帮助?
如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨