GUIDES
API(β)の使い方ガイド
姿勢ナビ(運営: 株式会社Saucer)は、写真1枚で姿勢を AI 分析し、その結果をお客様との会話の入口にして、初回体験の入会率・継続率を上げる、整体院・接骨院、パーソナルジム、ピラティス、エステサロンなどの店舗向け SaaS です。料金は月5,000円〜。
β版です。予告なく仕様を変更する場合があります。
-
姿勢分析 API(β)はどう使い始めればいいですか?
姿勢ナビの API(β)は、店舗の管理画面で発行した API キーを Bearer 認証に付けて呼び出します。疎通確認(GET /v1/ping)のあと、顧客を登録し、正面と側面の写真2枚を POST /v1/examinations に送ると分析が始まり、20〜60 秒ほどで結果を取得できます。β版のため、予告なく仕様を変更する場合があります。
-
写真からの姿勢分析を、自社のアプリやシステムに組み込むには?
姿勢ナビの API(β)では、2つの方法で姿勢分析を自社のアプリやシステムに組み込めます。自社のアプリで撮った正面・側面の写真を API に送ると、サーバーで分析して結果を JSON で返します。撮影から姿勢ナビの画面を使いたい場合は、撮影画面・結果画面を開く URL(30 分・1 回限り)を API で発行し、新しいタブかリダイレクトで開きます。
-
姿勢分析の完了を Webhook で受け取るには?
姿勢ナビの API(β)では、API キーごとに Webhook の送信先 URL を設定すると、写真を送って依頼した分析が完了・失敗したときに、その URL へ署名付きで POST します。受信側は X-Shiseinavi-Signature を署名シークレットで検証し、X-Shiseinavi-Event-Id で重複を除いて、10 秒以内に 2xx を返します。失敗した配送は 24 時間後まで段階的に再送されます。
-
AI エージェント(Claude Code・ChatGPT など)から姿勢ナビを操作するには?
姿勢ナビの API(β)は通常の REST API で、仕様を OpenAPI(YAML)で公開しているので、HTTP を呼べる AI エージェントからそのまま使えます。Claude Code のように手元でコマンドを実行できるエージェントには、ドキュメントの URL を渡し、API キーを環境変数に入れて頼みます。ChatGPT のカスタムアクションなど OpenAPI を読み込めるツールには、OpenAPI を読み込ませて API キー(Bearer)を設定します。
仕様の詳細は API ドキュメント(β) をご覧ください。