SDK etkinleştirme, yapılandırma ve kişiler

1Etkinleştirme

Secret key ile POST /api/v1/sdk/activate. Gövde: instance_id (zorunlu, 8 ile 128 karakter; kurulumun sabit bir fingerprint'i), base_url, platform, platform_version, terms_version, accepted_by (Koşulları kimin kabul ettiği). 200 {project, org, enabled, public_key, features: {security_monitoring, plan, seats}} yanıtı verir; sınırsız için seats null'dur. 409 {reason: 'instance_bound_elsewhere'} bu kurulum zaten başka bir projeye raporluyorsa; 409 {reason: 'project_has_instance'} bu anahtar zaten farklı bir kuruluma aitse.

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

2Yapılandırma

Secret key ve X-Blipit-Instance ile GET /api/v1/sdk/config. {public_key, features} yanıtı verir. Bir plan değişikliğini ya da yeni bir public key'i fark etmek için ara sıra sorgulayın (Odoo her on dakikada bir yapar).

3Kişiler

Secret key ve X-Blipit-Instance ile PUT /api/v1/sdk/contacts. Gövde {companies: [{id, name, people: [{id, name, email}]}]}. Farklı kişiler üyeler, davetler ve e-posta kurallarıyla birlikte planın kullanıcı sayısına dahil edilir. 200 {used, seats, plan} ya da liste kullanıcı sayısının ötesinde kişi ekleyecekse 409 {reason: 'seats_exceeded', seats, used, plan} yanıtı verir; yalnızca küçülen bir liste her zaman kabul edilir.

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

Bilmekte fayda var

• Etkinleştirmeden sonra o kurulumdan gelen her istek X-Blipit-Instance taşımalıdır; uyuşmazlık 403 'this key is bound to a different instance' alır.
• Bir kez bağlandıktan sonra bağlama yalnızca Blipit panelinden değiştirilebilir.