めぐりび連携API

めぐりびの連携APIを使うと、葬儀社から石材店へ新しいご家族の情報を引き継いだり、法要の予定と区画の台帳を受け取ったりできます。使うには、つなぎたい石材店に鍵を発行してもらってください。

できること

葬儀社のシステムから、紙の同意書で同意を得た新しいご家族の情報を、石材店の「確認待ち」に送れます。石材店が内容を確かめてから台帳に入れます。

寺院・霊園・仏壇店・花屋のシステムは、法要の予定（区画・回忌・年月）と区画の台帳（手入れの履歴）を受け取れます。

お名前と連絡先は、鍵に pii:read があり、石材店が設定でオンにし、そのご家族が共有に同意している場合だけ含まれます。

鍵のもらい方

つなぎたい石材店に連絡し、「設定 → 連携」で鍵を発行してもらってください。鍵は発行したときに1回だけ表示されます。

鍵は Authorization ヘッダーに Bearer で付けます。1本の鍵で1分に60回まで呼べます。

葬儀社には、引継ぎの受付（intakes:write）と状況の確認（intakes:read）の両方を持つ1本の鍵を発行します。送った鍵と別の鍵では、引継ぎの状態は見えません。

GET /api/partner/v1/ping で鍵を確かめられます（組織のIDと、その鍵で使えるスコープを返します）。

使えるエンドポイント（OpenAPI の定義から表示）

メソッド	パス	中身
GET	/api/partner/v1/ping	鍵の確認
POST	/api/partner/v1/intakes	引継ぎを送る（intakes:write）
GET	/api/partner/v1/intakes/{id}	送った引継ぎの状態（intakes:read）
GET	/api/partner/v1/memorials	法要の予定（memorials:read）
GET	/api/partner/v1/plots	区画の台帳（plots:read）
GET	/api/partner/v1/plots/{id}	1区画と手入れの履歴（plots:read）

引継ぎを送る

POST /api/partner/v1/intakes に、施主・故人・墓所と紙の同意の記録を送ります。Idempotency-Key ヘッダーが必要です。

同意書は、下の「引継ぎの同意書（ひな形）」を印刷して使ってください（版 mb-intake-2026-10）。紙の同意（method="paper"・transfer=true）が無い引継ぎは受け付けません。

引継ぎの同意書（ひな形）

curl -X POST https://meguribi-app.com/api/partner/v1/intakes \
  -H "Authorization: Bearer mb_live_xxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Idempotency-Key: 5b0e7c2a-1d4e-4c1b-9f11-3a2b8c7d6e5f" \
  -H "Content-Type: application/json" \
  -d '{
  "external_ref": "SK-2026-0915-001",
  "head": {"name": "佐藤 一郎", "phone": "019-000-0000"},
  "deceased": {"name": "佐藤 ハナ", "death_date": "2026-09-15"},
  "grave": {"cemetery_name": "〇〇霊園", "section": "B-3"},
  "consent": {"method": "paper", "form_version": "mb-intake-2026-10", "signed_on": "2026-09-18",
              "transfer": true, "share_with_partner": true, "benchmark": false}
}'

201 {"id":"0b6f5c1e-…","status":"pending","external_ref":"SK-2026-0915-001","received_at":"2026-10-01T09:00:00+09:00"}

送った引継ぎの状態は GET /api/partner/v1/intakes/{id} で確かめられます（pending・accepted・rejected・expired）。

法要の予定

GET /api/partner/v1/memorials?from=2027-03&to=2027-03 で、その範囲の法要の予定を返します。from・to を省くと今月から2か月後まで、範囲は12か月までです。

curl "https://meguribi-app.com/api/partner/v1/memorials?from=2027-03&to=2027-03" \
  -H "Authorization: Bearer mb_live_…"

{"data":[{"id":"7b1e0c52-…:3","kaiki":3,"kaiki_label":"三回忌","memorial_month":"2027-03",
  "plot":{"id":"c41d…","cemetery_name":"〇〇霊園","section":"A-12"}}],"next_cursor":null}

区画の台帳

GET /api/partner/v1/plots で区画の一覧、GET /api/partner/v1/plots/{id} で1区画と手入れの履歴（新しい順に20件）を返します。

curl "https://meguribi-app.com/api/partner/v1/plots?cemetery=〇〇霊園" -H "Authorization: Bearer mb_live_…"

お知らせ（Webhook）

送る出来事：intake.accepted（引継ぎを取り込んだ）、memorial.upcoming（法要の2か月前）、order.recorded（受注を記録した）。

X-SBGG-Signature ヘッダーの t と v1 で署名を確かめてください。v1 は、署名用の秘密で「t.本文」を HMAC-SHA256 にした16進数です。300秒以上ずれていたら捨ててください。

届く順番は保証しません。受け手は created_at で判断してください。同じ出来事には同じ id が付きます。

{"id":"evt_order_recorded_a1c3…","type":"order.recorded","created_at":"2026-10-01T09:00:00+09:00","org_id":"…",
 "data":{"order_id":"a1c3…","kind":"engraving","amount_jpy":55000,"status":"won","ordered_on":"2026-10-01",
         "plot_id":"c41d…","notice":{"kaiki":3,"memorial_month":"2027-03"},"intake_id":null}}

// Node.js：署名の確かめ方
import crypto from 'node:crypto';
function verify(secret, rawBody, header) {
  const p = Object.fromEntries(header.split(',').map((kv) => kv.split('=')));
  if (Math.abs(Date.now() / 1000 - Number(p.t)) >= 300) return false;
  const v1 = crypto.createHmac('sha256', secret).update(p.t + '.' + rawBody).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(v1), Buffer.from(p.v1));
}

エラー

401 鍵が無い・違う・止められた。403 スコープが足りない。404 見つからない（ほかの店のIDも404）。409 同じ番号をすでに受け付けている。422 consent_required・validation_error。429 回数の上限（Retry-After を見てください）。402 石材店が引継ぎを受け付けていない。

OpenAPI 3.1 の定義（openapi.json）

めぐりび 連携API