图片展示

成 都 狮 龙 书 廊 科 技 有 限 责 任 公 司

Chengdu Shilong Pearson Education technology  Limited  Liability  Technology Group Co., Ltd.

头条号网站验证文件

好啊,"搜 "

 

好啊,"搜 "

 

客服电话:13904310313   

 

公司总机:028-67876373              

 

钉钉客服:17684321066                   

 

备案电话:15680712313 

 

商标注册服务电话:15210354365  

 


发给
707322756
2022年5月16日(星期一) 下午2:32
详情

 
作为全球云计算领军企业,亚马逊云科技依托在海外的深厚积累与成熟解决方案,携手跨境电商企业共同发起 “护航行动”,旨在为中国跨境电商卖家提供一站式跨境护航服务,让中国卖家享受多维度权益和帮助:

 加快海外部署
 提升投资回报
 助力全球布局

 
 
加入“护航行动”
 
 
亚马逊云科技 IoT 广泛应用于

 

 
• 亚马逊云科技 IoT + AI 的解决方案落地智能家居应用场景
• 海尔、泉峰、萤石等多家标杆企业产品理念和出海实践心得分享
• 高峰对话,探讨智能家居产业的挑战和机遇

 

 
亚马逊云科技解决方案架构师 潘显坤

 

 
❐ 从云端到边缘端,实现终端在边缘节点的连接与数据处理。

❐ Amazon IoT Analytics、Amazon IoT Events、Amazon IoT SiteWise、Amazon IoT Things Graph 等解决方案,可以实现大量 IoT 数据的复杂分析,掌握用户的使用习惯从而为优化体验提供有力支撑。

❐ 基于亚马逊云科技 IoT 技术,快速构建智能家居产品:
1. 在设备端、物理端把各种语言的 SDK,或者边缘网关的产品,类似 Greengrass 边缘网关的解决方案部署上去;
2. 将数据传输到云端上,通过 IoT Core 做定义与管理,把这些数据转化到 S3 数据湖或其他业务需求所对应的数据库之中;
3. 通过构建机器学习能力,把产品能力更加丰富。

亚马逊云科技拥有大量合作伙伴与 ISV,帮助企业打造端到端产品方案,快速构建智能家居产品的落地。

 
 
海尔智家副总裁 于建强

 

 
海尔智家以智家大脑作为智慧家庭的核心技术引擎,通过建设 IoT、大数据、AI 三朵云,结合由家庭中各种传感组合形成的全屋感知神经单元,来打造智能连接、智能感知、智能决策、智能交互相应的基础技术能力。同时通过对用户行为的分析,精准地定位用户画像和预测需求,提供主动服务,完成从 “被动执行” 到 “管家服务” 的体验升级。

 
 
萤石 IoT 开发平台业务负责人 刘冀晖

 

 
萤石以物联网云平台为核心的技术底座,同时以音视频能力为特有的技术栈,面对不同的行业,实现智能化、联网化、可视化,依托亚马逊云科技提供 IaaS 基础设施与丰富的功能组件,通过云 + 模组 + APP + AI 一站式服务,帮助合作伙伴实现智能化、可视化。

在 AIoT 时代,生产工具是云、是 AI,是 5G,生产资料是数据,生产力是连接力、计算力、智力、传输力、持久力。实际上,新经济与数字经济的背后是五力之争,萤石网络和亚马逊云科技的结合,分别在这五个力方面各取所长,共同服务客户。随着多模态感知技术,特别是音视频技术在物联网当中的应用,音视频 + AI 与传统家居深度耦合,为智能单品带来价值创新。平台接入能力 + 智能化方案能力 + 数据挖掘能力 + 出海运营能力四力加持,才能为合作伙伴和最终用户带来全球全链路全生命周期的 AIoT 服务。

 
 
泉峰产品经理 安可遥

 

 
泉峰把所有园林工具进行电动化,创立了 EGO 电动工具平台,主要工作场景就是园林相关的服务,很多会用到亚马逊云科技公有云层面的服务,同时打通跟用户相关,跟供应商管理相关、跟企业资源相关的各套系统,实现商流、物流、信息流的打通并与亚马逊云科技长期合作。

 
 
BroadLink 博联智能软件总监 康海洋

 
 
博联智能是以 Wifi 连网的插座开始进入 IoT 领域,后边逐步扩展到智能家居,到现在做全屋智能。公司的主要业务是做四大块,一个是消费者产品,第二是提供整体解决方案,第三是智能家装,第四是针对地产前装市场做的全屋智能解决方案。目前博联智能管理的集群有 20 多个,服务器目前最新的数字已经超过 1500 多台,在全球所有的主要国家都有集群和服务器分布。博联智能在 2014 年就开始使用亚马逊云科技服务器,基本上亚马逊云科技有数据中心的点都有开通集群,给用户提供本地化的服务。

 
 
海信智慧生活智能生活部长 秦勇

 
 
海信是 1*3*N 一屏三域全业态来打造海信智慧新生活战略,包含了智慧家庭、智慧社区和智慧城市,打通智慧家庭、智慧社区和智慧城市,构建全场景全业态全智能的智能新生活解决方案。其中在智慧家庭板块的总体架构分为平台层和设备层,设备层是有智能板并赋能于传统家电,作为智能家居、智能家居和家用机器人,构成了设备层。平台层,包含了海信的云平台与大数据,接入海信的设备或者第三方的设备,同时构造上层的应用与服务,这些应用包含美食、健康、娱乐、购物、社交。海信的智能家电产品是销往全球,海信智能板模组销售量也是上千万级的。在海外,海信云基础云平台由亚马逊云科技提供技术支持,海信希望与亚马逊携手共进,成为世界一流多系统解决方案提供商。

 
 
 
企业出海或个人体验
 
超过200项服务,包含80余种产品免费试用
 
登录海外区控制台
 
发展中国业务
 
近百项服务,包含宁夏区域20余种产品免费试用
 
登录中国区控制台
 
 
 
AWS海外区域咨询热线 1010 0866 点击在线咨询AWS云计算专家          

 
我的账户 | 新手课堂 | 产品 | 解决方案 | 定价 | 合作伙伴 | 文档 | 培训 | 活动与网络研讨会 | AWS Activate | 最新资讯 | 博客 | 分析师报告
 
如果您不希望再收到 Amazon Web Services 的电子邮件, 请在此取消订阅。
Amazon Web Services, Inc. 是隶属 Amazon.com, Inc. 的一家附属公司。Amazoncom 是 Amazon.com 的注册商标。
本邮件由 Amazon Web Services, Inc.(地址:410 Terry Ave. North, Seattle, WA 98109)或其 联属公司编写分发。
© 2022,Amazon Web Services, Inc. 或其联属公司。保留所有权利。参阅本司 隐私声明。
 

腾讯文档开放API

作者:毛凌国 浏览: 发表时间:2022-07-15 04:24:37 来源:狮龙书廊

腾讯档开放API

  1. API 概览

文档相关接口名称

接口功能

/openapi/v1/doc/create

建文

/openapi/v1/doc/delete

除自己创建文

/openapi/v1/doc/rename

修改文档标题

/openapi/v1/doc/query

查询文档信息

/openapi/v1/doc/import

导入文

/openapi/v1/doc/export

导出文档,权限需要单独申请

/openapi/v1/doc/trans

文档转让

/openapi/v1/doc/copy

生成副本

/openapi/v1/doc/list

查询文档列表

/openapi/v1/doc/list_created

增量拉取我创建的文档列表

/openapi/v1/doc/list_browse

增量拉取我浏览的文档列表

登录相关接口名称

接口功能

/openapi/v1/user/auth

获取用户登录态

权限相关接口名称

接口功能

/openapi/v1/privilege/set

设置文档权限

/openapi/v1/privilege/get

获取文档权限

打开文档相关接口名称

接口功能

/openapi/v1/jump/open

打开文档



  1. 开发者与应用注册

开发者需要先到官网API接口(https://docs.qq.com/open-api.html)“立即申请”登记信息,后续将会有线

1.调用步骤

1.1 术语解释

  • 第三方平台:指使用腾讯文档开放API的第三方开发者
  • 文档ID:字符串,用来标识文档的唯一ID
  • 文档类型:数字,0:Word,1:Excel,2:Form

1.2 获取用户登录态


说明:

  • 为保证安全性,获取登录态的过程中需要回调第三方平台查询用户信息
  • 由于本步骤中尚未获取到用户登态,所以 1.2 调用 auth 接口 和 1.3 查询用户信息接口需要对接口进行签名,具体的签名算法见 【接口鉴权
  • 1.2 接口名为 /openapi/v1/user/auth
  • 1.3 第三方需提供查询用户信息 get_third_userinfo
  • 1.5 返回 toid,toid_key(加密的A2)

1.3 调用API接口

以 创建文档接口(/openapi/v1/doc/create)为例

2.请求方式

  • 通信协议:HTTPS
  • 接口地址:
    • 请求的HOST:第三方申请到的独立域名,例如:example.txdocs.qq.com。如果不申请使用独立域名,则使用此通用域名:tob.txdocs.qq.com。
    • 请求方式:独立域名---https://example.txdocs.qq.com/{接口名} (示例)

通用域名---https://tob.txdocs.qq.com/{接口名}

  • 请求方法:支持 POST 和 GET 请求。
  • POST 请求目前仅支持 Content-Type 类型为 application/x-www-form-urlencoded
  • 字符编码:均使用UTF-8编码

3.公共参数

公共参数是用于标识用户和接口鉴权目的的参数,如非必要,在每个接口单独的接口文档中不再对这些参数进行说明,但每次请求均需要携带这些参数,才能正常发起请求。

为避免接口参数冲突,公共参数的参数名为全大写字母。


参数名称

类型

必选

描述

APPID

Integer

应用注册成功后获取

TIMESTAMP

Integer

当前 UINX 时间戳,即发起 API 请求的时间,如果时间与当前时间相差过大,会引起签名过期错误

NONCE

Integer

随机正整数,用于防止重放攻击,短时间内 Nonce 不能重复

SIGNATURE

String

请求签名,用来验证此次请求的合法性,具体计算方法见【接口鉴权】

TOID

String

用户ID

TOID_KEY

String

用户登录态






4.接口鉴权

获取登录态时需要对接口进行签名,腾讯文档开放平台在调用第三方接口时,第三方平台也需要对请求进行签名校验已确保请求来源合法。


以 登录接口(/openapi/v1/user/auth) 为例,发送的请求参数如下:


参数名称

类型

参数值

描述

APPID

Integer

1001

应用的 APPID

TIMESTAMP

Integer

1465185768

当前 UINX 时间戳

NONCE

Integer

4529053332324

随机正整数

third_token

String

xxxxx

第三方用户 token



注意:这里只是例子,用于说明接口签名的过程,实际接口参数可能与此不同

4.1 对参数排序

首先对所有请求参数按参数名的字典序( ASCII 码)升序排序

注意:

1)只按参数名行排序,参数值保持对应即可,不参与比大小;

2)按 ASCII 码比大小,如 InstanceIds.2 要排在 InstanceIds.12 后面,不是按字母表,也不是按数值。

用户可以借助编程语言中的相关排序函数来实现这一功能,如 php 中的 ksort 函数。


上述示例参数的排序结果如下:



'APPID' : 1001

'NONCE' : 4529053332324,

'TIMESTAMP' : 1465185768,

'third_token':xxxxx


4.2 拼接请求字符串

此步骤生成请求字符串。 将把上一步排序好的请求参数格式化成“参数名称”=“参数值”的形式

注意:“参数名称“和“参数值”为原始值而非url编码后的值。

然后将格式化后的各个参数用"&"拼接在一起。


最终生成的请求字符串为:


APPID=1001&NONCE=4529053332324&TIMESTAMP=1465185768&third_token=xxxxx



4.1.3 拼接签名原文字符串

此步骤生成签名原文字符串。 签名原文字符串由以下几个参数构成:

  • 求方法: 支持 POST 和 GET 方式,这里使用 GET 请求,注意方法为全大写。
  • 请求主机: 根据实际请求的域名填写
    • 例如:example.txdocs.qq.com
  • 请求路径: 即接口名称
  • 请求字符串: 即上一步生成的请求字符串


签名原文串的拼接规则为:

请求方法 + 请求域名 +请求路径 + ? + 请求字符串


示例的拼接结果为:


GETexample.txdocs.qq.com/openapi/v1/auth?APPID=1001&NONCE=4529053332324&TIMESTAMP=1465185768&third_token=xxxxx



4.3 生成签名串

此步骤生成签名串。 首先使用 HMAC-SHA1 算法对上一步中获得的签名原文字符串进行签名,然后将生成的签名串使用 Base64 进行编码,即可获得最终的签名串。


具体代码如下,以 PHP 语言为例:


$appkey = 'fakeAppkey';

$srcStr = 'GETexample.txdocs.qq.com/openapi/v1/auth?APPID=1001&NONCE=4529053332324&TIMESTAMP=1465185768&third_token=xxxxx';

$signStr = base64_encode(hash_hmac('sha1', $srcStr, $appkey, true));

echo $signStr;



最终得到的签名串为:


Lrj7E+bzqHA4zKnnBENruUnuUQk=



使用其它程序设计语言开发时,可用上面示例中的原文进行签名验证,得到的签名串与例子中的一致即可。

4.4 签名串编码

生成的签名串并不能直接作为请求参数,需要对其进行 URL 编码。

注意:如果用户的请求方法是 GET,或者请求方法为 POST 同时 Content-Type 为 application/x-www-form-urlencoded ,则对所有请求参数值均需要做 URL 编码。

非 ASCII 字符在 URL 编码前需要先以 UTF-8 进行编码。


如上一步生成的签名串为:


Lrj7E+bzqHA4zKnnBENruUnuUQk=



经过 urlencode 之后,最终得到的签名串请求参数(SIGNTURE)为:


Lrj7E%2BbzqHA4zKnnBENruUnuUQk%3D



注意:有些编程语言的 http 库会自动为所有参数进行 urlencode ,在这种情况下,就不需要对签名串进行 URL 编码了,否则两次 URL 编码会导致签名失败。

5.错误码

5.1 网关返回的错误码

错误代码

错误描述

1000

API网关:内部错误

1001

API网关:TOID_KEY 错误

1002

API网关:逻辑错误

1003

API网关:网络错误

1004

API网关:参数错误

1005

API网关:获取应用信息失败

1006

API网关:应用状态错误

1007

API网关:签名错误

1008-2000

API网关:预留



5.1 CGI返回的错误码(部分)

错误代码

错误描述

1001

登录无效

10000

无APPID

10001

无TOID信息

10002

无第三方token信息

10003

登录失败

10004

登录签名为空

10005

用户信息拉取失败

10006

用户信息APPID与第三方APPID不匹配

10007

APPKey不存在

10008

APP信息拉取失败

10009

JUMPCODE为空

10010

JUMPCODE读取失败



  1. API接口详情

下述接口示例中均以example.txdocs.qq.com为HOST来进行举例,实际请求时请使用申请到的第三方独立域名,无独立域名则使用通用域名tob.txdocs.qq.com。


另外,如果用户的请求方法是 GET,或者请求方法为 POST 同时 Content-Type 为 application/x-www-form-urlencoded ,则对所有请求参数值均需要做 URL 编码。(若出现签名错误、参数错误等提示,请检查是否有正确地URL编码)

1.登录相关接口

1.1 接口描述

描述

定义

接口名

/openapi/v1/user/auth

请求方式

POST

请求格式

application/x-www-form-urlencoded



本接口用于获取用户的登录态


注意:此接口需要签名验证

1.2 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数。


参数名称

类型

必选

描述

APPID

Integer

公共参数

TIMESTAMP

Integer

公共参数

NONCE

Integer

公共参数

SIGNATURE

String

公共参数



下面登录方式三选一,每次只能传一种方式


企业微信 Token/Code 登录时,传下列参数

参数名称

类型

必选

描述

third_token

String

第三方票据,用户向第三方验证用户信息

login_type

Integer

填 0



QQ 登录时,传下列参数

参数名称

类型

必选

描述

third_daid

Integer

第三方登录域

third_puin

Integer

第三方登录QQ号

third_pskey

String

第三方登录PSkey

login_type

Integer

填 1



微信登录时,传下列参数

参数名称

类型

必选

描述

third_wx_appid

String

第三方微信appid

third_openid

String

第三方微信登录OpenID

third_access_token

String

第三方微信access token

login_type

Integer

填 2


第三方回调登录时,传下列参数

参数名称

类型

必选

描述

third_token

String

第三方票据,用户向第三方验证用户信息

login_type

Integer

填 3



1.3 输出参数

参数名称

类型

描述

toid

String

用户ID

toid_key

String

用户登录key

jump_code

String

跳转用一次性 code



若是采用第三方回调登录的方式,如果登录时回调第三方提供的用户信息回调服务出错,则此登录接口会返回错误:{“cgicode”:10003, "ret":43810, "msg":"0x16184 response error, msg=third toid serv error}

1.4 示例

输入示例:

https://example.txdocs.qq.com/openapi/v1/user/auth?third_token=1001




输出示例:

{

"ret": 0,

"msg": "ok",

"data": {

"toid": "144115210451427855",

"toid_key": "L8HfmGLnqHHie%252FYLT6f%252BOqivGW9WusoWWRkCvTwqANPqp8zj",

"jump_code": "4c0015fec4e0cfad148858dabdd985ca4ac5d8a02a2db87816f51575ce7b2369"

}

}




2.文档相关接口

2.1 创建文档

2.1.1 接口描述

描述

定义

接口名

/openapi/v1/doc/create

请求方式

POST

请求格式

application/x-www-form-urlencoded



本接口用来创建文档。若要打开文档,请使用/openapi/v1/jump/open接口(4.1)。

2.1.2 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数

参数名称

类型

必选

描述

APPID

Integer

企业AppID,企业接入时申请获得

TOID

String

用户ID,登录后获得

TOID_KEY

String

用户登录Key,登录后获得

title

String

文档标题

doc_type

Int

文档类型 0=文档 1=表格 2=收集表

disable_auto_rename

Int

是否禁止自动修改标题能力,1为禁止



2.1.3. 输出参数

参数名称

类型

描述

doc_id

String

文档ID,此ID用在后面各种文档操作接口

doc_url

String

文档地址


2.1.4. 示例

输入示例:

POST https://example.txdocs.qq.com/openapi/v1/doc/create


title=name&doc_type=1




输出示例:

{

"ret": 0,

"msg": "ok",

"data": {

"doc_id": "DY0dLUHNZWFVFTXdt",

"doc_url": "//docs.qq.com/doc/DV3Jic1Z1Y0FxcE1J?appid=101520907&od_appid=101520907"

}

}





2.2 删除文档

2.2.1 接口描述

描述

定义

接口名

/openap/v1/doc/delete

请求方式

POST

请求格式

application/x-www-form-urlencoded



本接口用来删除文档,此接口会校验toid是否是该文档的拥有者(拥有者并非一定是创建者,因为拥有者可以转让,参考 /openapi/v1/doc/trans)


2.2.2 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数。

参数名称

类型

必选

描述

APPID

Integer

企业AppID,企业接入时申请获得

TOID

String

用户ID,登录后获得

TOID_KEY

String

用户登录Key,登录后获得

doc_id

String

文档ID,创建文档后获得



2.2.3 输出参数

2.2.4 示例

输入示例:

POST https://example.txdocs.qq.com/openapi/v1/doc/delete


doc_id=xx




输出示例:

{

"ret": 0,

"msg": "ok"

}



2.3 还原文档

2.3.1 接口描述

描述

定义

接口名

/openapi/v1/doc/recover

请求方式

POST

请求格式

application/x-www-form-urlencoded



本接口用来还原文档,此接口会校验toid是否是该文档的拥有者(拥有者并非一定是创建者,因为拥有者可以转让,参考 /openapi/v1/doc/trans)


2.3.2 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见公共请求参数。

参数名称

类型

必选

描述

APPID

Integer

企业AppID,企业接入时申请获得

TOID

String

用户ID,登录后获得

TOID_KEY

String

用户登录Key,登录后获得

doc_id

String