你可以通过cURL
工具的例子来了解实时通信引擎的用法。
环境准备
- 在任何支持 HTTPS 的平台和编程语言中,都可以使用 Wilddog REST API
1. 创建应用
首先,你需要在控制面板中创建应用。
2. 写入数据
对于 Wilddog 任何 节点,你可以将该节点相对于根节点的路径作为数据地址。在数据地址后加上.json
,作为 URL 发送标准的 HTTPS REST 请求,以此写入与读取数据。在本文档中,我们使用 cURL 工具发送 HTTPS 请求。
例如,已有数据是这样的那么若要操作users节点的数据,数据路径为 /rest/quickstart/users
:
{ |
使用PUT
请求写入数据:
curl -X PUT -d '{ "alanisawesome": { "name": "Alan Turing", "birthday": "June 23, 1912" } }' 'https://docs-examples.wilddogio.com/rest/quickstart/users.json' |
成功的请求会收到 HTTP 状态码 200 ,返回值中包含我们写入 Wilddog 的数据:
{ |
3. 读取数据
GET
请求用于读取 /rest/quickstart/users
下的数据:
curl -X GET 'https://docs-examples.wilddogio.com/rest/quickstart/users.json' |
成功的请求会收到 HTTP 状态码 200 ,返回值中包含路径下的数据:
{ |
将来我们会提供各种编程语言的库,使 REST API 更加简便。
4.数据安全
你可以在 Sync 中使用规则表达式进行数据访问权限的控制。规则表达式可以实现以下功能:
- 数据访问权限控制
- 用户访问权限控制
- 数据格式校验
- 数据索引
规则表达式的具体使用,请参考 安全性与规则。
注意:
初始配置下,所有人都能读写你的应用数据,请及时在 实时通信引擎-读写权限 中更改规则表达式。