SDK のアクティベーション、設定、担当者

1アクティベート

シークレットキーで POST /api/v1/sdk/activate。ボディ：instance_id（必須、8〜128文字。インストールの安定したフィンガープリント）、base_url、platform、platform_version、terms_version、accepted_by（利用規約に同意した人）。レスポンスは 200 {project, org, enabled, public_key, features: {security_monitoring, plan, seats}}。seats は無制限の場合 null。409 {reason: 'instance_bound_elsewhere'} はこのインストールが既に別のプロジェクトに報告している場合。409 {reason: 'project_has_instance'} はこのキーが既に別のインストールに属している場合。

curl https://in.blipit.io/api/v1/sdk/activate \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <secret key>" \
  -d '{"instance_id":"7c1e0f9a2b3d4e5f6a7b8c9d0e1f2a3b","platform":"odoo","platform_version":"19.0","terms_version":"2026-09-28","accepted_by":"admin@example.com"}'

2設定

シークレットキーと X-Blipit-Instance で GET /api/v1/sdk/config。レスポンスは {public_key, features}。プランの変更や新しい公開キーに気づけるよう、時々ポーリングしてください（Odoo は10分ごとに行います）。

3担当者

シークレットキーと X-Blipit-Instance で PUT /api/v1/sdk/contacts。ボディ {companies: [{id, name, people: [{id, name, email}]}]}。異なる担当者は、メンバー、招待、メールルールとともにプランのシートに対して数えられます。レスポンスは 200 {used, seats, plan}、またはリストがシートを超えて人を追加する場合は 409 {reason: 'seats_exceeded', seats, used, plan}。減るだけのリストは常に受け付けられます。

{
  "companies": [
    { "id": "1", "name": "Acme SG", "people": [{ "id": "2", "name": "Ana Lim", "email": "ana@example.com" }] },
    { "id": "2", "name": "Acme PH", "people": [{ "id": "7", "name": "Ben Cruz", "email": "ben@example.com" }] }
  ]
}

知っておくと便利

• アクティベーション後、そのインストールからのすべてのリクエストには X-Blipit-Instance が必要です。不一致の場合は 403「このキーは別のインスタンスに紐付けられています」を受け取ります。
• 一度紐付けられると、紐付けは Blipit ダッシュボードからのみ変更できます。