HTTP API

認証付きPOSTひとつで送信。

スクリプト、ゲートウェイ、間欠動作する機器にはHTTPSが便利です。認証情報は1台のデバイスだけに紐づきます。

エンドポイント

デバイスのBearerキーを付けてJSONを送信します。数値、真偽値、短い文字列を最大32項目まで扱えます。

curl -X POST https://api.devicecamp.app/v1/devices/DEVICE_ID/telemetry \
  -H "Authorization: Bearer DEVICE_SECRET" \
  -H "Content-Type: application/json" \
  -d '{"temperature":22.4,"humidity":51}'

時刻と再送

計測時刻と受信時刻が異なる場合はrecorded_atを、再送する場合はmessage_idを指定します。同じIDは重複登録されません。

{"message_id":"reading-0042","recorded_at":"2026-07-25T08:00:00Z","metrics":{"temperature":22.4}}

拒否されたデータは保存されません

不正なUTF-8、重複JSONキー、未知のフィールド、非有限数、上限を超える値、不正な時刻、メトリクス型の変更は拒否されます。失敗したデータの一部だけが保存されることはありません。

認証の境界

エージェントトークンやブラウザCookieはデータ送信に使えません。キーが漏れた場合はデバイス管理画面から更新します。