Activation, configuration et contacts du SDK

1Activer

POST /api/v1/sdk/activate avec la clé secrète. Corps : instance_id (requis, 8 à 128 caractères ; une empreinte stable de l'installation), base_url, platform, platform_version, terms_version, accepted_by (qui a accepté les Conditions). Répond 200 {project, org, enabled, public_key, features: {security_monitoring, plan, seats}} ; seats vaut null pour illimité. 409 {reason: 'instance_bound_elsewhere'} quand cette installation envoie déjà à un autre projet ; 409 {reason: 'project_has_instance'} quand cette clé appartient déjà à une autre installation.

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"}'

2Configuration

GET /api/v1/sdk/config avec la clé secrète et X-Blipit-Instance. Répond {public_key, features}. Interrogez-le de temps en temps (Odoo le fait toutes les dix minutes) pour remarquer un changement de plan ou une nouvelle clé publique.

3Contacts

PUT /api/v1/sdk/contacts avec la clé secrète et X-Blipit-Instance. Corps {companies: [{id, name, people: [{id, name, email}]}]}. Les personnes distinctes comptent dans les sièges du plan avec les membres, invitations et règles e-mail. Répond 200 {used, seats, plan}, ou 409 {reason: 'seats_exceeded', seats, used, plan} quand la liste ajouterait des personnes au-delà des sièges ; une liste qui ne fait que diminuer est toujours acceptée.

{
  "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" }] }
  ]
}

Bon à savoir

• Après activation, chaque requête de cette installation doit porter X-Blipit-Instance ; une différence reçoit 403 « this key is bound to a different instance ».
• Une fois liée, la liaison ne peut être modifiée que depuis le tableau de bord Blipit.