Harici müşteri ilişkileri yönetimi sisteminizi B2COPY API ile entegre edin

hizmet yöneticisi ve imzalı JWT belirteçlerini (ES256) kullanarak harici CRM'den B2COPY API'ye istekleri yetkilendirin. Bu sayfada ön koşullar, anahtar oluşturma, jeton verilmesi ve B2COPY jetonlarının alınması/yenilenmesi konuları ele alınmaktadır.

Önkoşullar

• Yönetici panelinde, CRM adına API isteklerinde bulunan bir hizmet yöneticisi oluşturun (bunun belirli IP adresleriyle sınırlandırılması önerilir).
• CRM öğenizi, talepleri admin_id (hizmet yöneticisi kimliği), device_ip (istek IP) ve key_id (özel anahtar kimliği) içeren imzalı JWT'ler oluşturacak şekilde yapılandırın.

Anahtar oluştur

Belirteçleri imzalamak ve doğrulamak için bir EC (P-256) anahtar çifti oluşturun:

# Private key
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 \
  -out ec_private_pkcs8.pem

# Public key
openssl pkey -in ec_private_pkcs8.pem -pubout -out ec_public.pem

B2COPY desteğiyle iletişime geçin

Entegrasyonu tamamlamak için destek ekibine genel anahtarınızı (ec_public.pem), benzersiz anahtar tanımlayıcınızı ve API'yi çağıracak IP adreslerini gönderin. Destek, entegrasyonunuzu kaydeder ve genel anahtarı yapılandırır.

Erişim elde edin ve belirteçleri yenileyin

POST [host]/api/admin/auth/v2/admin/adminservice/authexternalcrm

curl -X POST "[host]/api/admin/auth/v2/admin/adminservice/authexternalcrm" \
  -d '{ "external_token": "<your-generated-jwt-token>" }'

Yanıt, hizmet yöneticisi için erişim ve yenileme belirteçlerini döndürür; erişim belirtecini diğer tüm isteklerin Authorization başlığına ekleyin.

{
  "accessToken": "<access-token>",
  "refreshToken": "<refresh-token>"
}

Erişim belirtecini yenileyin

POST [host]/api/admin/auth/v2/admin/adminservice/refreshtoken

curl -X POST "[host]/api/admin/auth/v2/admin/adminservice/refreshtoken" \
  -H "Authorization: Bearer <refreshToken>"

Yeni bir erişim/yenileme belirteci çifti döndürür.