GUIDE

写真からの姿勢分析を、自社のアプリやシステムに組み込むには?

姿勢ナビの API(β)では、2つの方法で姿勢分析を自社のアプリやシステムに組み込めます。自社のアプリで撮った正面・側面の写真を API に送ると、サーバーで分析して結果を JSON で返します。撮影から姿勢ナビの画面を使いたい場合は、撮影画面・結果画面を開く URL(30 分・1 回限り)を API で発行し、新しいタブかリダイレクトで開きます。

β版です。予告なく仕様を変更する場合があります。 更新日: 2026-10-29

2つの方法の違い

方法A: 写真を API で送る方法B: 姿勢ナビの画面を開く(埋め込み URL)
撮影自社アプリで撮る姿勢ナビの撮影画面で撮る
結果の見せ方JSON を受け取り、自社の画面で表示する姿勢ナビの結果画面をそのまま開く
使う APIPOST /v1/examinations(write:examinations)POST /v1/clients/{uid}/embed_tokens(embed)
向いている場合自社アプリの中で体験を完結させたい撮影のガイドや結果画面を作らずに使いたい

どちらの方法でも、診断は店舗の画面の診断履歴・結果画面・手渡し PDF に同じように残ります。

共通: 顧客をそろえる

自社システムの顧客 ID を external_id に入れて登録しておくと、あとから ID で引けます。

KEY=$(uuidgen)   # この依頼の冪等キー(再送でも同じ値を使う)
curl -s -X POST "https://posture-api.shiseinavi.com/v1/clients" \
  -H "Authorization: Bearer $SNV_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: $KEY" \
  -d '{"name":"山田太郎","external_id":"CRM-12345"}'

curl -s "https://posture-api.shiseinavi.com/v1/clients?external_id=CRM-12345" -H "Authorization: Bearer $SNV_KEY"

通信が切れたときは、同じ KEY で同じコマンドをもう一度実行してください。新しい登録・診断は作られず、同じ応答が返ります(KEY は依頼1回ごとに1度だけ作り、再送では作り直さない)。

方法A: 写真を送って結果を受け取る

KEY=$(uuidgen)   # この依頼の冪等キー(再送でも同じ値を使う)
curl -s -X POST "https://posture-api.shiseinavi.com/v1/examinations" \
  -H "Authorization: Bearer $SNV_KEY" -H "Idempotency-Key: $KEY" \
  -F client_uid=CL12345678 \
  -F "images[standing]=@front.jpg" -F "images[standing_side]=@side.jpg"

通信が切れたときは、同じ KEY で同じコマンドをもう一度実行してください。新しい登録・診断は作られず、同じ応答が返ります(KEY は依頼1回ごとに1度だけ作り、再送では作り直さない)。

  • 写真は JPEG / PNG、1枚 10MB 以下。全身が写り、撮影画面と同じ構図のものを使います
  • 撮影画面と同じ 3:4(480×640)の枠に収めて分析します。縦長・横長の写真には黒帯が入ります
  • 20〜60 秒ほどで analysis_status が completed になります。ポーリング(5 秒間隔程度)か Webhook で受け取ります
  • notify_client: true を付けると、完了時に顧客へ LINE / メールで知らせます

方法B: 撮影画面・結果画面を開く URL を発行する

curl -s -X POST "https://posture-api.shiseinavi.com/v1/clients/CL12345678/embed_tokens" \
  -H "Authorization: Bearer $SNV_KEY" -H "Content-Type: application/json" \
  -d '{"kind":"scan"}'
kind開く画面
scan診断画面(撮影方法の選択から)。撮影して診断を作れます
mypage顧客のマイページ(閲覧のみ)
result指定した診断の結果(examination_uid が必須。閲覧のみ)
  • URL は 30 分・1 回限り です。開いたあとの画面も 30 分有効です
  • 開き方は新しいタブかリダイレクトをおすすめします(iframe での表示はカメラの権限・Cookie の扱いを検証中です)

関連