GUIDE
写真からの姿勢分析を、自社のアプリやシステムに組み込むには?
姿勢ナビの API(β)では、2つの方法で姿勢分析を自社のアプリやシステムに組み込めます。自社のアプリで撮った正面・側面の写真を API に送ると、サーバーで分析して結果を JSON で返します。撮影から姿勢ナビの画面を使いたい場合は、撮影画面・結果画面を開く URL(30 分・1 回限り)を API で発行し、新しいタブかリダイレクトで開きます。
β版です。予告なく仕様を変更する場合があります。 更新日: 2026-10-29
2つの方法の違い
| 方法A: 写真を API で送る | 方法B: 姿勢ナビの画面を開く(埋め込み URL) | |
|---|---|---|
| 撮影 | 自社アプリで撮る | 姿勢ナビの撮影画面で撮る |
| 結果の見せ方 | JSON を受け取り、自社の画面で表示する | 姿勢ナビの結果画面をそのまま開く |
| 使う API | POST /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 の扱いを検証中です)