# HTTP API 快速入门

## 准备工作

请先向SenseCAP销售那里获得您的SenseCAP帐户，并确保您可以登录SenseCAP 云平台：<https://sensecap.seeed.cc> 。

## 获取Access Key ‌

‌ 1、登录SenseCAP云平台：<https://sensecap.seeed.cc>。 ‌&#x20;

2、前往“Organization/Security Credentials”。 ‌&#x20;

3、点击“Create access key”。 ‌&#x20;

4、获取“Access ID”和“Access Key”。

![](https://1710350650-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Le9rLTKMDdzc4diAdKs%2F-Li7j4HncUYnGZThGmJQ%2F-Li7jLhiRD00TDyJhHyV%2F1jpg.jpg?alt=media\&token=0bf7b337-2616-480c-b160-6b47e2f90507)

## 获取所有账号下已绑定设备的EUI（设备ID）

使用curl发出HTTP请求。下面的示例将调用API来获取属于您的所有设备的EUI。

```bash
curl --user "<access_id>:<access_key>" \
    https://sensecap-openapi.seeed.cc/1.0/lists/devices/eui
```

请将您刚获取到的Access ID和Access Key将上面的`<access_id>`和`<access_key>`替换掉。然后将会得到和下面一样格式的输出结果：

```bash
{
    "code": "0",
    "data": {
        "gateway": [
            "2CF7F1121130003C"
        ],
        "node": [
            "2CF7F12210400070",
            "2CF7F12210400083",
            "2CF7F1221040007E",
            "2CF7F12210400074"
        ]
    },
    "time": 0.288
}
```

在结果中包含两类设备“gateway”网关和“node”传感器设备

* “gateway”下面有一个ID为"2CF7F1121130003C"的网关，如果有多个网关，则设备ID会以列表方式返回。
* “node”下面有四个设备ID，对应了四种传感器

可以在云平台上查看设备，验证API结果是否一致

![网关设备信息](https://1710350650-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Le9rLTKMDdzc4diAdKs%2F-Li7j4HncUYnGZThGmJQ%2F-Li7mxLwExE36oLAaqF7%2F2.jpg?alt=media\&token=6e479f07-59a9-4e72-ba8e-954a978bbcc9)

![传感器设备列表信息](https://1710350650-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Le9rLTKMDdzc4diAdKs%2F-Li7j4HncUYnGZThGmJQ%2F-Li7n43wILAwhNxa8wzz%2F3.jpg?alt=media\&token=54001907-f356-4ee8-bd5d-cc4c7af303cc)

如果用[Postman](https://www.getpostman.com/)等API调用工具，同样可以获得上述结果，在参数配置时，在Authorization页面将TYPE选择为“Basic Auth”，并将Access ID填入“Username”，Access Key填入Password栏位，HTTP的请求选择“GET”，在URL中输入“[https://sensecap-openapi.seeed.cc/1.0/lists/devices/eui](https://open.api.sensecap.seeed.cc/1.0/lists/devices/eui)”，最后点击Send来请求API

![](https://1710350650-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Le9rLTKMDdzc4diAdKs%2F-Li7j4HncUYnGZThGmJQ%2F-Li7no5sDJ4L_4AqEXK9%2F4.jpg?alt=media\&token=0207138e-898c-4fd5-8cd4-64bc6736a8aa)