কেনাকাটার জন্য সামগ্রী এপিআই-এ, আপনি Account সংস্থানের একটি ক্ষেত্র সহ ব্যবহারকারীদের এবং তাদের অ্যাক্সেসের অধিকারগুলি পরিচালনা করেছেন। Merchant API এটিকে User এবং সংশ্লিষ্ট পদ্ধতি (তৈরি, মুছে, পেতে, তালিকা, পথ) নামের উৎসর্গীকৃত সম্পদ দিয়ে প্রতিস্থাপন করে। আরও তথ্যের জন্য, আপনার অ্যাকাউন্টে অ্যাক্সেস নিয়ন্ত্রণ দেখুন।
মূল পার্থক্য
কেনাকাটার জন্য সামগ্রী API-এর তুলনায়, মার্চেন্ট API ব্যবহারকারী পরিচালনার জন্য নিম্নলিখিত সুবিধাগুলি অফার করে:
- ডেডিকেটেড রিসোর্স : কে আপনার বণিক কেন্দ্র অ্যাকাউন্ট অ্যাক্সেস করতে পারে এবং তারা কী করতে পারে তা নিয়ন্ত্রণ করার জন্য এটি আরও দানাদার এবং সরাসরি উপায় প্রদান করে।
- RESTful সম্পদের নাম : মার্চেন্ট এপিআই-এ, একটি সম্পূর্ণ রিসোর্স নাম দ্বারা
Userসংস্থান সনাক্ত করুন, উদাহরণস্বরূপ,accounts/12345/users/example@example.com। -
mealias : আপনি প্রমাণীকৃত ব্যবহারকারীকে উল্লেখ করতে রিসোর্সের নামের একটি ইমেল ঠিকানার জায়গায় aliasmeব্যবহার করতে পারেন, উদাহরণস্বরূপ,accounts/12345/users/me। - একত্রিত অ্যাক্সেসের অধিকার : মার্চেন্ট API Content API থেকে বুলিয়ান অ্যাক্সেস ক্ষেত্রগুলিকে একত্রিত করে (উদাহরণস্বরূপ,
admin,reportingManager) একটি একক, পুনরাবৃত্তিযোগ্যaccess_rightsফিল্ডে। - ব্যবহারকারীর আমন্ত্রণ এবং যাচাইকরণ : মার্চেন্ট এপিআই একটি স্পষ্ট ব্যবহারকারীর অবস্থা (
PENDINGবাVERIFIED) উপস্থাপন করে। আপনি যখন একটি নতুন ব্যবহারকারী তৈরি করেন, তারা আমন্ত্রণ গ্রহণ না করা পর্যন্ত একটিPENDINGঅবস্থায় থাকে৷ এটি ব্যবহারকারীর স্থিতিতে API দৃশ্যমানতা প্রদান করে, যা কেনাকাটার জন্য সামগ্রী API-তে উপলব্ধ ছিল না। ## অনুরোধ যোগ করুন
বণিক API ব্যবহারকারীদের পরিচালনা করতে নিম্নলিখিত অনুরোধের URL ব্যবহার করে:
-
GET /accounts/v1/accounts/{account}/users/{email} -
GET /accounts/v1/accounts/{account}/users -
POST /accounts/v1/accounts/{account}/users -
PATCH /accounts/v1/accounts/{account}/users/{email} -
DELETE /accounts/v1/accounts/{account}/users/{email}
নিম্নলিখিত সারণীটি কেনাকাটার জন্য সামগ্রী API এবং বণিক API-এর মধ্যে অনুরোধের URLগুলির তুলনা করে৷
| বিবরণ অনুরোধ করুন | কেনাকাটার জন্য সামগ্রী API | বণিক API |
|---|---|---|
| একটি অ্যাকাউন্টের জন্য ব্যবহারকারীদের পান | GET {api_version}/{merchantId}/accounts/{accountId} | GET {api_version}/accounts/{account}/users |
| একটি ব্যবহারকারী তৈরি করুন | PATCH {api_version}/{merchantId}/accounts/{accountId} | POST {api_version}/accounts/{account}/users |
| একজন ব্যবহারকারীকে আপডেট করুন | PATCH {api_version}/{merchantId}/accounts/{accountId} | PATCH {api_version}/accounts/{account}/users/{email} |
| একটি ব্যবহারকারী মুছুন | PATCH {api_version}/{merchantId}/accounts/{accountId} | DELETE {api_version}/accounts/{account}/users/{email} |
শনাক্তকারী
নিম্নলিখিত সারণী শপিং এবং মার্চেন্ট API-এর জন্য সামগ্রী API-এর মধ্যে অনুরোধে ব্যবহৃত শনাক্তকারীর তুলনা করে।
| শনাক্তকারীর বিবরণ | কেনাকাটার জন্য সামগ্রী API | বণিক API |
|---|---|---|
| অ্যাকাউন্ট শনাক্তকারী | accountId | অ্যাকাউন্টে account accounts/{account} |
| ব্যবহারকারী শনাক্তকারী | AccountUser অবজেক্টের মধ্যে email_address | অ্যাকাউন্টে email accounts/{account}/users/{email} |
পদ্ধতি
নিম্নলিখিত সারণী শপিং এবং মার্চেন্ট API-এর জন্য সামগ্রী API-এর মধ্যে পদ্ধতির তুলনা করে।
| কেনাকাটার জন্য সামগ্রী API | বণিক API | প্রাপ্যতা এবং নোট |
|---|---|---|
accounts.update | users.create | একটি অ্যাকাউন্টের জন্য একটি নতুন ব্যবহারকারী তৈরি করে। |
accounts.get | users.get | একক ব্যবহারকারী পুনরুদ্ধার করে। |
accounts.get | users.list | একটি অ্যাকাউন্টের জন্য সমস্ত ব্যবহারকারীদের তালিকাভুক্ত করে৷ |
accounts.update | users.update | ব্যবহারকারীর অ্যাক্সেস অধিকার আপডেট করে। |
accounts.update | users.delete | একটি অ্যাকাউন্ট থেকে একটি ব্যবহারকারী মুছে দেয়. |
বিস্তারিত ক্ষেত্রের পরিবর্তন
নিম্নলিখিত হিসাবে আপনার ক্ষেত্র ব্যবহার আপডেট করুন:
| কেনাকাটার জন্য সামগ্রী API | বণিক API | বর্ণনা |
|---|---|---|
users (পুনরাবৃত্ত AccountUser ) | users (পুনরাবৃত্ত User ) | User সংস্থান এখন তার নিজস্ব পরিষেবা সহ একটি শীর্ষ-স্তরের সংস্থান। |
AccountUser.email_address | CreateUserRequest.user_id এবং User.name এর অংশ | ব্যবহারকারীর ইমেল ঠিকানা এখন সম্পদ নামের অংশ. সৃষ্টির সময় user_id ক্ষেত্রে এটি নির্দিষ্ট করুন। |
AccountUser.admin | access_rights: "ADMIN" | Merchant API বুলিয়ান admin ফিল্ডকে access_rights এনামে ADMIN মান দিয়ে প্রতিস্থাপন করে। |
AccountUser.order_manager , AccountUser.payments_manager , AccountUser.payments_analyst | access_rights: "STANDARD" | মার্চেন্ট API এই ভূমিকাগুলিকে STANDARD অ্যাক্সেসের অধিকারে প্রতিস্থাপন করে। |
AccountUser.reporting_manager | access_rights: "PERFORMANCE_REPORTING" | reporting_manager ভূমিকা এখন PERFORMANCE_REPORTING অ্যাক্সেসের অধিকার। |
AccountUser.read_only | access_rights: "READ_ONLY" | read_only ভূমিকা এখন READ_ONLY অ্যাক্সেসের অধিকার। |
| পাওয়া যায় না | User.name | ব্যবহারকারীর সম্পূর্ণ সম্পদের নাম রয়েছে, উদাহরণস্বরূপ, accounts/{account}/users/{email} । |
| পাওয়া যায় না | User.state | ব্যবহারকারীর আমন্ত্রণের স্থিতি নির্দেশ করে, হয় PENDING বা VERIFIED ৷ |