1. 首页>
  2. 腾讯云代理

[产品使用] 云API的使用入门

腾讯云 2017年02月05日 浏览742

腾讯云代理 腾讯云直播申请 游戏上云

摘要: -云API介绍 腾讯云提供云API供您使用请求调用的方式来操作云资源,跟WEB管理中心上进行操作是一样的。请先充分了解腾讯云资源产品、及其使用和收费方式。 云API文档中心:http://www.qcloud.com/doc/api

-云API介绍
腾讯云提供云API供您使用请求调用的方式来操作云资源,跟WEB管理中心上进行操作是一样的。请先充分了解腾讯云资源产品、及其使用和收费方式。
云API文档中心:http://www.qcloud.com/doc/api

本文档内容:
申请安全凭证-云API密钥
接口说明
    1.接口描述
    2.输入参数
    3.输出参数

    4.错误码
调试工具的使用
    step1: 输入 SecretId 和 SecretKey
    step2: 选择请求方法
    step3&4: 输入请求的域名和接口名
    step5: 输入请求的区域
    step6: 输入完整的请求参数(接口的私有参数)
    测试通过输入参数进行过滤

SDK的使用

申请安全凭证-云API密钥。 
在第一次使用云API的时候,用户首先需要在腾讯云网站上申请安全凭证,安全凭证包括 SecretId 和 SecretKey, SecretId 是用于标识 API 调用者的身份,SecretKey是用于加密签名字符串和服务器端验证签名字符串的密钥。SecretKey 必须严格保管,避免泄露。
https://console.qcloud.com/capi
01.png 

然后会获取到这样的密钥对
02.png 

接口说明
以查看云服务器实例列表为例文档:

http://www.qcloud.com/doc/api/229/%E6%9F%A5%E7%9C%8B%E5%AE%9E%E4%BE%8B%E5%88%97%E8%A1%A8
1.接口描述
描述接口的功能,对应的域名和接口名
03.png 

2.输入参数
输入参数,例如对结果进行筛选或者是相关的配置参数
04.png 

3.输出参数
输出的结果详情
05.png 
instanceSet 实例信息
各字段的描述
06.png 

4.错误码
每个接口有自己对应的错误码,可在文档中心进入各接口查看各自的错误码。
http://www.qcloud.com/doc/api/229/%E9%94%99%E8%AF%AF%E7%A0%81

调试工具的使用
通过调试工具,避免了一些自己环境的一些问题,可专门对接口进行测试,看是否参数还是哪里填写的有问题。
调试工具地址:
http://182.254.136.27/yunapi/tools/

云API列表

http://www.qcloud.com/doc/api以查询云服务器实例接口DescribeInstances作为例子,测试下云API接口的调用

查询实例列表接口介绍:
http://www.qcloud.com/doc/api/229/%E6%9F%A5%E7%9C%8B%E5%AE%9E%E4%BE%8B%E5%88%97%E8%A1%A8
step1: 输入 SecretId 和 SecretKey
输入云API密钥
07.png 

step2: 选择请求方法
08.png 

step3&4: 输入请求的域名和接口名
不同的接口有各自对应的域名和接口名,可在该接口的说明上查看
09.png 
10.png 

step5: 输入请求的区域
查询云服务器列表是通过不同地域来查找的,所以这里需要加入地域参数。有些功能无地域概念的可不用此参数,例如CDN。
11.png 

step6: 输入完整的请求参数
这里先测试不输入其他参数,获取这个账号下所有上海的实例信息。
12.png 

然后查看返回结果,这里返回了24个实例,对应各字段说明可参考接口说明文档
13.png 

测试通过输入参数进行过滤
通过实例ID(可以使用instanceId和unInstanceId,建议使用unInstanceId )进行过滤
其他参数不变,在输入完整的请求参数里面,输入过滤参数,可输入多个参数,参数与参数之间通过&连接
这里测试筛选两台机器,参数中输入instanceIds.0=该实例ID,和下一个实例instanceIds.1=实例ID
14.png 

然后查看返回的结果
15.png 

SDK的使用
云API是不能直接使用的,是需要下载SDK一起使用。
SDK是为了让开发者能够在自己的代码里更快捷方便的使用腾讯云的API而开发的SDK工具包
参考文档:
http://www.qcloud.com/doc/api/229/%E7%A4%BA%E4%BE%8B%E4%BB%A3%E7%A0%81这里以PHP为例
首先下载SDK
16.png 

17.png 

解压SDK文件到PHP环境目录
18.png 

可在demo.php中修改成您的请求信息
19.png 

然后请求页面返回结果
20.png 


auto_1452.png


原文地址:http://bbs.qcloud.com/thread-13206-1-1.html

相关文章

在线客服
淘宝购买
腾讯云直播申请 title=
+成为腾讯云VIP客户 腾讯云直播申请 客服电话

15818558013

0755-33940501-803

0755-33940501-808