クイックスタート

検証したい内容に合った、最短の経路を選んでください。認証情報とデバイスアクセスが機能するかどうかだけを確認したい場合は、2つのcurlリクエストから始めてください。完全なガイド付きフローが必要な場合はBrunoを使ってください。

検証方法を選ぶ

2分での検証

2つのcurlリクエストでアクセストークンを取得し、デバイス一覧を取得します。コレクションやSDKのセットアップは不要です。

curlで検証

完全な検証

Brunoコレクションを使って、認証・デバイス照会・リアルタイム状態・任意の制御を検証します。

Brunoで検証

サーバー統合

検証が成功したら、TypeScript、Python、またはGoのSDKをバックエンドに統合します。

SDKを統合

対話的な検証

オンラインPlaygroundを開き、ツールをインストールせずにテストデバイスを操作し、REST APIとWebSocketのメッセージを比較できます。

Playgroundを試す

必要なもの

• API Clientの clientId と clientSecret
• device:read 権限
• デバイス一覧にデータが入っていることを期待する場合は、少なくとも1台のデバイスへのアクセス

API Keysを取得で認証情報を作成してください。実機がまだない場合は、support@svnwi.com にテスト用認証情報について問い合わせてください。

認証情報はサーバー上に保管してください

WLTE OpenAPIはサーバーサイド統合を前提としています。clientSecret をブラウザコード、モバイルアプリ、公開リポジトリ、公開ログに置かないでください。

推奨される順序

1. curlでの検証を実行して、認証情報とデバイスアクセスを確認します。
2. リアルタイム状態を確認したり、コマンドを安全に検証したりしたい場合はBrunoを使います。
3. REST APIとWebSocketの挙動を視覚的に比較したい場合はOpenAPI Playgroundを開きます。
4. 動作するフローをSDK、または独自のサーバーコードに移行します。
5. 本番アーキテクチャについては統合ガイドに進んでください。

リクエストが失敗した場合は、よくある失敗を参照してください。