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

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

URL: https://shiseinavi.com/guides/embed-posture-analysis-in-app
更新日: 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 で引けます。

```bash
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: 写真を送って結果を受け取る

```bash
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](https://shiseinavi.com/guides/receive-analysis-webhook) で受け取ります
- `notify_client: true` を付けると、完了時に顧客へ LINE / メールで知らせます

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

```bash
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 の扱いを検証中です）

## 関連

- [API ドキュメント（β）: 写真を送って分析する](https://shiseinavi.com/docs/api#analysis)
- [API ドキュメント（β）: 埋め込み URL](https://shiseinavi.com/docs/api#embed)
- [姿勢分析 API（β）はどう使い始めればいいですか？](https://shiseinavi.com/guides/posture-analysis-api-quickstart)

---

姿勢ナビ（運営: 株式会社Saucer）は、写真1枚で姿勢を AI 分析し、その結果をお客様との会話の入口にして、初回体験の入会率・継続率を上げる、整体院・接骨院、パーソナルジム、ピラティス、エステサロンなどの店舗向け SaaS です。料金は月5,000円〜。
