仕様書

環境情報

  本番環境 開発環境
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