SDK etkinleştirme, devre dışı bırakma, yapılandırma ve kişiler

Endpoint POST /api/v1/sdk/activate, POST /api/v1/sdk/deactivate, GET /api/v1/sdk/config, PUT /api/v1/sdk/contacts

Odoo modülü bu dört çağrıyı kullanır. Kurulum başına tek anahtar bağlaması, public key ve plan özellikleri isteyen herhangi bir sunucu tarafı entegrasyon bunları aynı şekilde kullanabilir.

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.

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

2Devre dışı bırak

Secret key ve X-Blipit-Instance ile POST /api/v1/sdk/deactivate. Gövde (isteğe bağlı): released_by (bağlantıyı kimin kestiği, örneğin bir e-posta). Bu kurulumun projeye bağlamasını siler, böylece başka bir veritabanı anahtarı bağlayabilir, ve denetim günlüğüne key.instance_released yazar. 200 {released: true} ya da bu kurulum bağlı değilse 200 {released: false} yanıtı verir; yani tekrarlamak güvenlidir. X-Blipit-Instance eksikse 400, bilinmeyen anahtar için 401, public key ya da başka bir projeye bağlı kurulum için 403. Sonrasında o instance'ı taşıyan istekler, kurulum yeniden etkinleştirilene kadar 403 alır.

sh
curl https://in.blipit.io/api/v1/sdk/deactivate \
  -H "Content-Type: application/json" -H "X-Blipit-Key: <secret key>" -H "X-Blipit-Instance: 7c1e0f9a2b3d4e5f6a7b8c9d0e1f2a3b" \
  -d '{"released_by":"admin@example.com"}'

3Yapılandırma

Secret key ve X-Blipit-Instance ile GET /api/v1/sdk/config. {public_key, features, sdk, odoo} 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).

4Kiş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.

json
{
  "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 devre dışı bırakma (kurulumun kendisinden) ya da Blipit paneli üzerinden değişir.

Takıldınız mı? support@blipit.io adresine e-posta gönderin. Her projenin anahtarları ve proje id'si app.blipit.io içindeki API anahtarları altındadır.