仕様書
環境情報
| 本番環境 | 開発環境 | |
|---|---|---|
| BizStack コンソール | https://console.bizstack.cloud/login | https://bizconsole-staging.tinkermode.com/ |
| Developer コンソール | https://console.tinkermode.com | https://console-staging.tinkermode.com |
| REST API | http://api.tinkermode.com https://api.tinkermode.com |
http://api-staging.tinkermode.com https://api-staging.tinkermode.com |
| MQTT | mqtt://mqtt.tinkermode.com:1883 mqtts://mqtt.tinkermode.com:8883 |
mqtt://mqtt-staging.tinkermode.com:1883 mqtts://mqtt-staging.tinkermode.com:8883 |
| Quotas | User: 10 Homes: 10 Devices: 10 Smart Modules: 5 API Rate Limit |
Entity: 10 User: 10 Homes: 10 Devices: 6 Smart Modules: 3 API Rate Limit |
追記事項
API Rate Limit
Device:
- Number of connections a device can make: 5
- Number of data send requests per minute: 600 (10 req/sec)
User:
- 本番環境
- A user (API Key) can 1500 requests per minute (25 req/sec)
- 開発環境
- A user (API Key) can 600 requests per minute (10 req/sec)
Project:
- A project API key can make 3000 requests per minute (50 req/sec)
- A project global limitation is 6000 req/min per project. This is applied to all traffic in a project.
- Example of project global limitation: 60 users accessing MODE platform with 101 req/min rate. Although the access of each user is below the threshold (600 req/min), the total number of accesses per project may exceed 6000 req/min. In such a case, some requests will be rejected.
エラー時の挙動
- REST API: Return 429 {"reason": "RATE_LIMIT_EXCEEDED"} HTTP response, with Retry-After header to tell the duration of time that the client is allowed to access.
- MQTT: MQTT session will be terminated
