ユーザー行動追跡

フォーム入力フローの例

ユーザーがデジタル署名でQRコードをスキャンし、フォームにリダイレクトされた後、各ステップの後にSRサーバーに更新情報を送信することを想定しています。
例：FORM_SUBMITTED -> FORM_REVIEWING -> FORM_APPROVED
その後、「クーポン発行」エンドポイントを使用してユーザーにクーポンを発行します。

ユーザー行動追跡APIの使い方

エンドポイントパス

POST <BASE_URL>/smart-engage/post/update-session-status

リクエストパラメータ

種類	名前	必須	例
リクエストボディ	session_id	必須	8960569d-db50-4742-8668-1da5c8ddf652
リクエストボディ	new_status	必須	FORM_REVIEWING

リクエストボディ

{
  "session_id": "8960569d-db50-4742-8668-1da5c8ddf652",
  "new_status": "FORM_REVIEWING"
}

レスポンスステータス

ステータスコード	意味
200	成功
400	不正なリクエスト
401	認証エラー
404	データが見つかりません
500	サーバー内部エラー

レスポンスボディ

成功

{
  "message": "Status updated successfully"
}

不正なリクエスト

{
  "error_msg": "Action already completed for session_id: 8960569d-db50-4742-8668-1da5c8ddf652"
}

認証エラー

{
  "error_msg": "API-KEY is invalid"
}

データが見つかりません

{
  "error_msg": "No record with session_id: 8960569d-db50-4742-8668-1da5c8ddf652"
}

サーバー内部エラー

{
  "error_msg": "Internal error occured, please check with our team"
}

エンドポイントへのリクエストコード例

cURL

curl -X POST "<BASE_URL>/smart-engage/post/update-session-status" \
     -H "Content-Type: application/json" \
     -H "API-KEY: <YOUR_API_KEY>" \
     -d '{
           "session_id": "8960569d-db50-4742-8668-1da5c8ddf652",
           "new_status": "FORM_REVIEWING"
         }'

Python

import requests

url = "<BASE_URL>/smart-engage/post/update-session-status"
headers = {
    "Content-Type": "application/json",
    "API-KEY": "<YOUR_API_KEY>"
}

data = {
    "session_id": "8960569d-db50-4742-8668-1da5c8ddf652",
    "new_status": "FORM_REVIEWING"
}

response = requests.post(url, json=data, headers=headers)
print(response.json())

PHP

<?php

$url = "<BASE_URL>/smart-engage/post/update-session-status";

$data = array(
    "session_id" => "8960569d-db50-4742-8668-1da5c8ddf652",
    "new_status" => "FORM_REVIEWING"
);

$headers = array(
    "Content-Type: application/json",
    "API-KEY: <YOUR_API_KEY>"
);

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // to capture response as a string
curl_setopt($ch, CURLOPT_POST, true); // use POST method
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); // attach JSON body
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers); // set headers

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'Request Error: ' . curl_error($ch);
} else {
    $responseData = json_decode($response, true);
    print_r($responseData); // print decoded JSON response
}

curl_close($ch);
?>