会員連携 API
会員システムのサーバーから、配信対象・会員ランク・店頭でのクーポンの使用を送ります。
外部システムとサブスクラインを連携するための API リファレンス
外部システムからサブスクラインを呼び出す API が 3 つ、サブスクラインから外部システムへ送る通知が 1 つあります。
| やりたいこと | 使うもの | 呼び出し方 | 認証 |
|---|---|---|---|
| 会員番号の一覧でラベルを付け替えて配信対象にする、会員ランクを反映する、店頭で使ったクーポンを使用済みにする | 会員連携 API | PUT https://api.subscline.jp/api/v1/external/member-sync/... | 接続トークン(スコープ external_member_sync) |
| 会員プロフィールの取得と部分更新、予約・契約・決済履歴の取得、予約のキャンセルと契約の休会・再開・解約 | MCP API | POST https://api.subscline.jp/api/v2/mcp(JSON-RPC 2.0) | 接続トークン(スコープ read / member_profile_write / member_operations_write) |
| 購入完了や予約完了をきっかけに、そのお客様の LINE で自動応答を動かす | postback | 購入完了ページのタグ、または POST https://api.subscline.jp/api/v1/line/postback/{lcid}/{luid} | 接続トークン(スコープ postback) |
| 購入・予約・決済・契約の動きを、自社のシステムにすぐ反映する | イベント通知 (Webhook) | 登録した URL へサブスクラインが POST | 送信先ごとの secret による署名(X-Subscline-Signature) |
実装に使うトークンと secret は、サブスクラインの管理画面で発行します。発行の操作は操作マニュアルにまとめています。
| 使うもの | 発行する場所 | 操作マニュアルのページ |
|---|---|---|
| 会員連携 API の接続トークン | 「設定」>「AI/MCP連携」 | 外部の会員システムと連携する |
| MCP API の接続トークン | 「設定」>「AI/MCP連携」 | MCPコネクター |
| postback の発火用トークン | 「設定」>「AI/MCP連携」 | 自社サイトの購入完了ページから自動応答を発火させる |
| イベント通知の署名用 secret | 「設定」>「イベント通知(webhook)」 | 外部システムへのイベント通知 |
subscline_ で始まる文字列で、作成直後に一度だけ表示されます。external_member_sync と postback は、それぞれ専用の接続にします。このサイトは、連携先のシステムを実装する方に向けて、URL・リクエスト・応答・エラーなどの仕様をまとめたものです。管理画面の操作や機能の使い方は、操作マニュアル をご覧ください。