বিষয়বস্তুতে যান
ব্যবহারকারী গাইড কিভাবে করবেন গাইড সাপোর্ট ডেমো অনুরোধ করুন সাইন ইন করুন
Pushwoosh.com

API অ্যাক্সেস টোকেন

API অ্যাক্সেস টোকেন হল একটি অনন্য শনাক্তকারী যা আপনার অ্যাকাউন্টের একটি নির্দিষ্ট প্রজেক্ট বা একাধিক প্রজেক্টের জন্য নির্ধারিত হয়। এটি API-এর মাধ্যমে আপনার প্রজেক্টগুলি পরিচালনা করার জন্য আপনার অ্যাকাউন্টকে প্রমাণীকরণ করে, যার মধ্যে অ্যাকাউন্ট পরিবর্তন, বার্তা প্রেরণ, প্রজেক্ট সম্পাদনা ইত্যাদি অন্তর্ভুক্ত।

API অ্যাক্সেস টোকেন প্রকার

Anchor link to

Pushwoosh দুই ধরনের API অ্যাক্সেস টোকেন প্রদান করে: সার্ভার এবং ডিভাইস।

প্রতিটি টোকেন প্রকার শুধুমাত্র তার নির্দিষ্ট API স্কোপের জন্য বৈধ। ভুল টোকেন ব্যবহার করা হলে একটি প্রমাণীকরণ ত্রুটি ঘটবে।

সার্ভার API টোকেন

Anchor link to

সার্ভার API টোকেন ডিভাইস API-এর অধীনে থাকা পদ্ধতিগুলি ছাড়া সমস্ত API পদ্ধতির সাথে ব্যবহৃত হয়। এটি অনুরোধের বডিতে auth ফিল্ডে অন্তর্ভুক্ত করা উচিত।

ডিভাইস API টোকেন

Anchor link to

ডিভাইস API টোকেন একচেটিয়াভাবে ডিভাইস API পদ্ধতির সাথে ব্যবহৃত হয়। এটি Authorization হেডার ব্যবহার করে HTTP অনুরোধ হেডারে অন্তর্ভুক্ত করা উচিত। নিচে সঠিক হেডার ফরম্যাটের একটি উদাহরণ দেওয়া হল:

Authorization: Token <device_api_token>

<device_api_token>-কে আপনার আসল ডিভাইস API টোকেন মান দিয়ে প্রতিস্থাপন করুন।

API অ্যাক্সেস টোকেন তৈরি এবং পরিচালনা

Anchor link to

আপনি Pushwoosh কন্ট্রোল প্যানেলের API Access বিভাগে আপনার API অ্যাক্সেস টোকেন দেখতে, তৈরি করতে এবং পরিচালনা করতে পারেন। এটি অ্যাক্সেস করতে, Settings → API Access-এ যান। Pushwoosh Demo App token

ডিফল্টরূপে, প্রতিটি অ্যাকাউন্টে Pushwoosh Demo App নামে একটি টোকেন থাকে, যা একটি সার্ভার টোকেন হিসাবে সেট আপ করা হয়।

একটি নতুন API অ্যাক্সেস টোকেন তৈরি করুন

Anchor link to

একটি নতুন API অ্যাক্সেস টোকেন তৈরি করতে:

  1. কন্ট্রোল প্যানেলের API Access বিভাগে যান।

  2. Generate New Token-এ ক্লিক করুন।

  3. যে উইন্ডোটি প্রদর্শিত হবে, সেখানে টোকেনের প্রকার নির্বাচন করুন:

    • সার্ভার বেশিরভাগ API পদ্ধতির জন্য ব্যবহৃত হয় (ডিভাইস API পদ্ধতি বাদে)।

    • ডিভাইস শুধুমাত্র ডিভাইস API পদ্ধতির জন্য ব্যবহৃত হয়।

  4. টোকেনের জন্য একটি নাম লিখুন।

  5. টোকেন তৈরি করতে Generate-এ ক্লিক করুন।

Generate a New Token

গুরুত্বপূর্ণ: নিশ্চিত করুন যে টোকেনটি আপনার Pushwoosh কন্ট্রোল প্যানেলের সঠিক অ্যাপে অ্যাক্সেস পেয়েছে। আরও জানুন

নতুন টোকেনটি API অ্যাক্সেস তালিকায় প্রদর্শিত হবে। সেখান থেকে, আপনি API অনুরোধে ব্যবহারের জন্য এর মান কপি করতে পারেন বা প্রয়োজন অনুযায়ী এর অ্যাক্সেস অনুমতি পরিচালনা করতে পারেন।

একটি টোকেন পরিচালনা করুন

Anchor link to

একটি বিদ্যমান API টোকেন পরিচালনা করতে, API Access বিভাগে টোকেন এন্ট্রির পাশে তিন-ডট মেনু (⋮)-তে ক্লিক করুন।

Manage a token

নিম্নলিখিত বিকল্পগুলি উপলব্ধ আছে:

সমস্ত প্রজেক্টে অ্যাক্সেস দিন

Anchor link to

টোকেনটিকে আপনার অ্যাকাউন্টের সমস্ত প্রজেক্টে অ্যাক্সেস দেয়। এটি টোকেনটিকে সমস্ত প্রজেক্ট জুড়ে API সম্পূর্ণরূপে ব্যবহার করার অনুমতি দেয়।

সমস্ত প্রজেক্ট থেকে অ্যাক্সেস প্রত্যাহার করুন

Anchor link to

আপনার অ্যাকাউন্টের সমস্ত প্রজেক্ট থেকে টোকেনের অ্যাক্সেস সরিয়ে দেয়। পুনরায় অ্যাক্সেস না দেওয়া পর্যন্ত টোকেনটি আর API ব্যবহার করতে পারবে না।

টোকেন সম্পাদনা করুন

Anchor link to

Edit API Token Permissions স্ক্রিনটি খোলে, যেখানে আপনি করতে পারেন:

  • টোকেনের নাম পরিবর্তন করুন

  • টোকেনের মান কপি করুন

  • তালিকা থেকে প্রজেক্ট নির্বাচন বা অনির্বাচন করে টোকেনটি কোন প্রজেক্টগুলি অ্যাক্সেস করতে পারবে তা বেছে নিন

  • টোকেনের অনুমতিগুলি চালু বা বন্ধ করুন: অ্যাকাউন্ট পরিবর্তন, অ্যাপ্লিকেশন পরিবর্তন, ট্যাগ পরিবর্তন, বার্তা প্রেরণ ও মুছে ফেলা

  • টোকেনটি যে অনুমোদিত IP ঠিকানা থেকে ব্যবহার করা যাবে তা সেট করুন (শুধুমাত্র সার্ভার টোকেন)

Permissions ট্যাবটি টোকেনের শেষ ব্যবহারের সময় এবং গত ৭ ও ৩০ দিনে এর কতগুলি কল প্রত্যাখ্যান করা হয়েছে তাও দেখায়।

Edit token screen with Permissions and Usage journal tabs, usage summary, and Allowed IP addresses field

আপনার পরিবর্তন করা শেষ হলে, সেগুলি প্রয়োগ করতে Save-এ ক্লিক করুন।

একটি টোকেনের ব্যবহার জার্নাল পরীক্ষা করুন

Anchor link to

Edit API Token Permissions স্ক্রিনে Usage journal ট্যাবটি খুলুন এবং গত ৯০ দিনে টোকেন দিয়ে করা প্রতিটি API কল পর্যালোচনা করুন। একটি ফলাফল (Any outcome, Accepted, Completed, Refused: IP address, Refused: no rights) এবং একটি তারিখের পরিসর বেছে নিন, তারপর তালিকাটি ফিল্টার করতে Apply-এ ক্লিক করুন। ফিল্টার করা লগটি একটি CSV ফাইল হিসাবে ডাউনলোড করতে Export CSV-তে ক্লিক করুন।

Usage journal tab with outcome and date filters and a CSV export button

টোকেন মুছুন

Anchor link to

আপনার অ্যাকাউন্ট থেকে স্থায়ীভাবে টোকেনটি সরিয়ে দেয়।

API অনুরোধ অনুমোদন করা

Anchor link to

API অনুরোধ অনুমোদন করতে, আপনি যে ধরনের API পদ্ধতি কল করছেন তার উপর ভিত্তি করে সঠিক ধরনের API অ্যাক্সেস টোকেন ব্যবহার করুন:

সার্ভার API পদ্ধতির জন্য

Anchor link to

অনুরোধের বডির “auth” ফিল্ডে টোকেনটি অন্তর্ভুক্ত করুন:

উদাহরণ:

{
  "request": {
    "application": "XXXXX-XXXXX",
    "auth": "yxoPUlwqm…………pIyEX4H", // এখানে আপনার সার্ভার টোকেন পেস্ট করুন
    "notifications": [{
      "send_date": "now",
      "content": "Hello world"
    }]
  }
}

ডিভাইস API পদ্ধতির জন্য

Anchor link to

ডিভাইস টোকেন ব্যবহার করুন। এটি নিম্নলিখিত ফরম্যাট ব্যবহার করে HTTP অনুরোধ হেডারে অন্তর্ভুক্ত করুন:

Authorization: Token <device_api_token>

<device_api_token>-কে আপনার আসল টোকেন মান দিয়ে প্রতিস্থাপন করুন।

একটি টোকেন নির্দিষ্ট IP ঠিকানায় সীমাবদ্ধ করুন

Anchor link to

একটি সার্ভার টোকেন অনুমোদিত উৎস IP ঠিকানার একটি তালিকায় সীমাবদ্ধ করা যেতে পারে। যখন তালিকাটি সেট করা হয়, Pushwoosh শুধুমাত্র সেই টোকেন দিয়ে করা API অনুরোধগুলি গ্রহণ করে যা একটি মিলে যাওয়া ঠিকানা থেকে আসে। ডিভাইস টোকেনগুলিতে এই বিকল্পটি নেই।

একটি সার্ভার টোকেনের জন্য Edit token খুলুন এবং Allowed IP addresses-এ ঠিকানাগুলি লিখুন:

  • ৫০টি পর্যন্ত এন্ট্রি যোগ করুন, IPv4 বা IPv6, প্রতিটি একটি একক ঠিকানা (203.0.113.7) বা একটি CIDR রেঞ্জ (203.0.113.0/24)।
  • একটি একক ঠিকানা একটি পূর্ণ-দৈর্ঘ্যের রেঞ্জ হিসাবে সংরক্ষণ করা হয়, যেমন 203.0.113.7 হয়ে যায় 203.0.113.7/32।
  • একটি রেঞ্জ তার নেটওয়ার্ক ঠিকানায় ক্যানোনিকালাইজ করা হয়, যেমন 203.0.113.7/24 হয়ে যায় 203.0.113.0/24।
  • 0.0.0.0/0 এবং ::/0 প্রত্যাখ্যান করা হয়, কারণ তারা প্রতিটি ঠিকানার সাথে মিলে যাবে এবং কোনো সীমাবদ্ধতা প্রদান করবে না।
  • টোকেনটি যেকোনো ঠিকানা থেকে ব্যবহারযোগ্য রাখতে তালিকাটি খালি রাখুন। এটি বিদ্যমান এবং নতুন টোকেনগুলির জন্য ডিফল্ট।

তালিকাটি প্রয়োগ করতে Save-এ ক্লিক করুন। যদি তালিকায় ৫০টির বেশি এন্ট্রি থাকে বা এমন কোনো এন্ট্রি থাকে যা একটি বৈধ ঠিকানা বা CIDR রেঞ্জ নয়, তাহলে সংরক্ষণ প্রত্যাখ্যান করা হয়।

যখন একটি অননুমোদিত ঠিকানা থেকে অনুরোধ আসে তখন কী হয়

Anchor link to

Pushwoosh টোকেন দিয়ে করা প্রতিটি API কলে অনুমোদিত IP ঠিকানাগুলি পরীক্ষা করে, তা v1 REST কল হোক (যেমন এই API রেফারেন্স জুড়ে নথিভুক্ত, উদাহরণস্বরূপ Messages API), একটি Messaging API v2 কল, বা একটি Customer Journey API কল। টোকেনের অনুমোদিত তালিকার বাইরের কোনো ঠিকানা থেকে করা অনুরোধ প্রত্যাখ্যান করা হয়।

আপনি কোন কলগুলি করছেন তার উপর ভিত্তি করে প্রতিক্রিয়ার ফরম্যাট ভিন্ন হয়:

  • বার্তা প্রেরণ, বাতিল এবং মুছে ফেলা, যেমন createMessage, চ্যানেল-নির্দিষ্ট create*Message পদ্ধতি, cancelMessage, এবং deleteMessage, HTTP 200 ফেরত দেয় এবং প্রতিক্রিয়া বডিতে "status_code": 403 থাকে, যা তাদের অন্যান্য অনুমোদন ব্যর্থতার মতোই।
  • অন্যান্য v1 REST কল, যেমন Applications, Tags, Geozones, Segmentation (Filters), Campaigns, Presets, Test devices, এবং Statistics APIs, একটি আসল HTTP 403 এবং একটি JSON ত্রুটি বডি ফেরত দেয়।
  • Messaging API v2 এবং Customer Journey API একটি PermissionDenied ত্রুটি সহ HTTP 403 ফেরত দেয়।