title: 快速入门

你可以通过cURL工具的例子来了解实时通信引擎的用法。

环境准备

  • 在任何支持 HTTPS 的平台和编程语言中，都可以使用 Wilddog REST API

1. 创建应用

首先，你需要在控制面板中创建应用。

2. 写入数据

对于 Wilddog 任何 节点，你可以将该节点相对于根节点的路径作为数据地址。在数据地址后加上.json，作为 URL 发送标准的 HTTPS REST 请求，以此写入与读取数据。在本文档中，我们使用 cURL 工具发送 HTTPS 请求。

例如，已有数据是这样的那么若要操作users节点的数据,数据路径为 /rest/quickstart/users：

  1. {
  2.   "rest": {
  3.     "quickstart": {
  4.       "users": {}
  5.     }
  6.   }
  7. }

使用PUT请求写入数据:

  1. curl -X PUT -d '{ "alanisawesome": { "name": "Alan Turing", "birthday": "June 23, 1912" } }' 'https://docs-examples.wilddogio.com/rest/quickstart/users.json'

成功的请求会收到 HTTP 状态码 200 ，返回值中包含我们写入 Wilddog 的数据：

  1. {
  2.   "alanisawesome": {
  3.     "birthday": "June 23, 1912",
  4.     "name": "Alan Turing"
  5.   }
  6. }

3. 读取数据

GET 请求用于读取 /rest/quickstart/users 下的数据： 

  1. curl -X GET 'https://docs-examples.wilddogio.com/rest/quickstart/users.json'

成功的请求会收到 HTTP 状态码 200 ，返回值中包含路径下的数据：

  1. {
  2.   "alanisawesome": {
  3.     "birthday": "June 23, 1912",
  4.     "name": "Alan Turing"
  5.   }
  6. }

将来我们会提供各种编程语言的库，使 REST API 更加简便。

4.数据安全

你可以在 Sync 中使用规则表达式进行数据访问权限的控制。规则表达式可以实现以下功能：

  • 数据访问权限控制
  • 用户访问权限控制
  • 数据格式校验
  • 数据索引

规则表达式的具体使用，请参考 安全性与规则。

注意：

初始配置下，所有人都能读写你的应用数据，请及时在 实时通信引擎-读写权限 中更改规则表达式。

5.更多使用