開発者ガイド & API

認証

APIキーの設定

すべてのリクエストに apikey ヘッダーを付けてください。キーは パイロットコンソール の「APIキー」カードで確認できます。

※ キーを確認するには サインイン が必要です。

テレメトリ送信

POST /rest/v1/flight_telemetry

機体・地上局・シミュレーターから1回のリクエストで位置データを送信します。レイテンシは世界のどこからでも 50ms 以下を目標としています。成功時のステータスコードは 201 Created です。

curl

curl -X POST 'https://cdocgepaxophadwnhhfm.supabase.co/rest/v1/flight_telemetry' \
  -H 'apikey: awos_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "drone_id": "your-drone-id",
    "latitude": 35.6895,
    "longitude": 139.6917,
    "altitude": 120,
    "timestamp": "2026-06-06T09:00:00Z"
  }'

Python

import requests

url = "https://cdocgepaxophadwnhhfm.supabase.co/rest/v1/flight_telemetry"
api_key = "awos_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

payload = {
    "drone_id": "your-drone-id",
    "latitude": 35.6895,
    "longitude": 139.6917,
    "altitude": 120,
}

resp = requests.post(
    url,
    json=payload,
    headers={"apikey": api_key, "Content-Type": "application/json"},
)
print(resp.status_code)  # 201 Created

データフォーマット

リクエストボディのフィールド

リアルタイム受信

WebSocket でテレメトリをリッスン

Supabase Realtime を使うと、新しいテレメトリが届いた瞬間にクライアントへプッシュされます。ポーリング不要で、フライトモニターのマップはこの仕組みで動いています。

JavaScript / TypeScript

import { createClient } from '@supabase/supabase-js'

const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY)

supabase
  .channel('telemetry-live')
  .on(
    'postgres_changes',
    { event: 'INSERT', schema: 'public', table: 'flight_telemetry' },
    (payload) => {
      console.log('新着テレメトリ:', payload.new)
    }
  )
  .subscribe()

基盤

通信とデータ保護の方式