メインコンテンツへスキップ

​
概要

ペルソナのセッションライフサイクルを管理します。ステータスラベルはテナントが自由に定義し、各遷移ごとにタイムスタンプが記録されます。 
入場 → CHAT → SHOPPING → PAYMENT → COMPLETE → 退場
 ↑       ↑        ↑          ↑         ↑        ↑
 t1      t2       t3         t4        t5       t6

​
セッション開始

POST /v1/persona/{persona_id}/session/start

​
レスポンス

{
  "success": true,
  "data": {
    "session_id": "a1b2c3d4-...",
    "persona_id": "d28fd898-...",
    "started_at": "2026-04-17T10:00:00Z"
  }
}
ペルソナごとに有効なセッションは1つのみ許可されます。すでに有効なセッションがある場合、409 SESSION_ACTIVEが返されます。

​
ステータススタンプ記録

POST /v1/persona/{persona_id}/session/stamp

​
リクエスト

{
  "status": "SHOPPING",
  "meta": {
    "zone": "processed_food",
    "cart_items": 3
  }
}
フィールドタイプ必須説明
statusstringOステータスラベル（テナント自由定義）
metaobjectXステータス関連の追加データ

​
レスポンス

{
  "success": true,
  "data": {
    "session_id": "a1b2c3d4-...",
    "status": "SHOPPING",
    "timestamp": "2026-04-17T10:05:00Z"
  }
}

​
セッション終了

POST /v1/persona/{persona_id}/session/end
セッションを終了し、全スタンプ履歴を返します。

​
レスポンス

{
  "success": true,
  "data": {
    "session_id": "a1b2c3d4-...",
    "persona_id": "d28fd898-...",
    "started_at": "2026-04-17T10:00:00Z",
    "ended_at": "2026-04-17T11:30:00Z",
    "stamps": [
      { "status": "ENTER", "timestamp": "2026-04-17T10:00:00Z" },
      { "status": "CHAT", "timestamp": "2026-04-17T10:02:00Z" },
      { "status": "SHOPPING", "timestamp": "2026-04-17T10:15:00Z" },
      { "status": "PAYMENT", "timestamp": "2026-04-17T11:20:00Z" },
      { "status": "COMPLETE", "timestamp": "2026-04-17T11:25:00Z" }
    ]
  }
}

​
現在のセッション取得

GET /v1/persona/{persona_id}/session
有効なセッションと現在までのスタンプ履歴を返します。

​
コード例

# セッション開始
curl -X POST https://api.ones1ght.com/v1/persona/$PERSONA_ID/session/start \
  -H "Authorization: Bearer $SDK_KEY"

# ステータススタンプ
curl -X POST https://api.ones1ght.com/v1/persona/$PERSONA_ID/session/stamp \
  -H "Authorization: Bearer $SDK_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "SHOPPING", "meta": {"zone": "wine"}}'

# 現在のセッション取得
curl https://api.ones1ght.com/v1/persona/$PERSONA_ID/session \
  -H "Authorization: Bearer $SDK_KEY"

# セッション終了
curl -X POST https://api.ones1ght.com/v1/persona/$PERSONA_ID/session/end \
  -H "Authorization: Bearer $SDK_KEY"