Attivazione SDK, configurazione e contatti

1Attiva

POST /api/v1/sdk/activate con la chiave segreta. Corpo: instance_id (obbligatorio, da 8 a 128 caratteri; un fingerprint stabile dell'installazione), base_url, platform, platform_version, terms_version, accepted_by (chi ha accettato i Termini). Risponde 200 {project, org, enabled, public_key, features: {security_monitoring, plan, seats}}; seats è null per illimitate. 409 {reason: 'instance_bound_elsewhere'} quando questa installazione segnala già a un altro progetto; 409 {reason: 'project_has_instance'} quando questa chiave appartiene già a un'installazione diversa.

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

2Configurazione

GET /api/v1/sdk/config con la chiave segreta e X-Blipit-Instance. Risponde {public_key, features}. Interrogalo di tanto in tanto (Odoo lo fa ogni dieci minuti) per notare un cambio di piano o una nuova chiave pubblica.

3Contatti

PUT /api/v1/sdk/contacts con la chiave segreta e X-Blipit-Instance. Corpo {companies: [{id, name, people: [{id, name, email}]}]}. Le persone distinte contano rispetto alle postazioni del piano insieme a membri, inviti e regole email. Risponde 200 {used, seats, plan}, oppure 409 {reason: 'seats_exceeded', seats, used, plan} quando l'elenco aggiungerebbe persone oltre le postazioni; un elenco che si limita a ridursi viene sempre accettato.

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

Buono a sapersi

• Dopo l'attivazione ogni richiesta da quell'installazione deve portare X-Blipit-Instance; una discrepanza riceve 403 'this key is bound to a different instance'.
• Una volta legato, il legame può essere cambiato solo dalla dashboard Blipit.