अपने बाहरी ग्राहक संबंध प्रबंधन को B2COPY API के साथ एकीकृत करें

एक सेवा व्यवस्थापक और हस्ताक्षरित JWT टोकन (ES256) का उपयोग करके अपने बाहरी CRM से B2COPY API के अनुरोधों को अधिकृत करें। यह पृष्ठ पूर्वापेक्षाएँ, कुंजी निर्माण, टोकन जारी करना और B2COPY टोकन प्राप्त/रीफ़्रेश करना समझाता है।

पूर्वावश्यकताएँ

एडमिन पैनल में एक service admin बनाएं, जिसकी ओर से CRM API अनुरोध करता है (इसे विशिष्ट IP पतों तक सीमित करने की अनुशंसा की जाती है)।
हस्ताक्षरित JWT उत्पन्न करने के लिए अपने CRM को कॉन्फ़िगर करें जिनके दावों में admin_id (सेवा व्यवस्थापक आईडी), device_ip (अनुरोध IP), और key_id (निजी कुंजी आईडी) शामिल हैं।

कुंजियाँ उत्पन्न करें

टोकन पर हस्ताक्षर करने और सत्यापित करने के लिए EC (P-256) कुंजी जोड़ी बनाएं:

# 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 सहायता टीम को केवल public कुंजी प्रदान करें - इसका उपयोग आपके हस्ताक्षरित JWTs को सत्यापित करने के लिए किया जाता है।

B2COPY सहायता से संपर्क करें

एकीकरण पूरा करने के लिए, सहायता टीम को अपनी सार्वजनिक कुंजी (ec_public.pem), अद्वितीय कुंजी पहचानकर्ता, और IP पते भेजें जो API पर कॉल करेंगे। समर्थन आपके एकीकरण को पंजीकृत करता है और सार्वजनिक कुंजी को कॉन्फ़िगर करता है।

पहुंच प्राप्त करें और टोकन ताज़ा करें

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

नाम	प्रकार	आवश्यक	विवरण
external_token	स्ट्रिंग	हाँ	आपके CRM द्वारा हस्ताक्षरित JWT उत्पन्न हुआ।

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

प्रतिक्रिया सेवा व्यवस्थापक के लिए पहुंच और ताज़ा टोकन लौटाती है; अन्य सभी अनुरोधों के Authorization हेडर में एक्सेस टोकन शामिल करें।

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

एक्सेस टोकन ताज़ा करें

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

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

एक नई एक्सेस/रीफ्रेश टोकन जोड़ी लौटाता है।