अपने बाहरी CRM को B2COPY API के साथ इंटीग्रेट करें

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

आवश्यक शर्तें

• एक बनाने के सेवा व्यवस्थापक एडमिन पैनल में जिसकी ओर से सीआरएम बनाता है API अनुरोध (इसे विशिष्ट आईपी पते तक सीमित करने की अनुशंसा की जाती है)।
• हस्ताक्षरित जेडब्ल्यूटी उत्पन्न करने के लिए अपने सीआरएम को कॉन्फ़िगर करें जिनके दावे शामिल हैं admin_id(सेवा व्यवस्थापक आईडी),device_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 सहायता

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

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

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

प्रतिक्रिया सेवा व्यवस्थापक के लिए पहुंच और ताज़ा टोकन लौटाती है; में एक्सेस टोकन शामिल करें 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>"

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