# Pushwoosh API ওভারভিউ

Pushwoosh API ডেভেলপারদের Pushwoosh প্ল্যাটফর্মের সাথে ইন্টারঅ্যাক্ট করার অনুমতি দেয়।

## Pushwoosh API দিয়ে আপনি কী করতে পারেন?
Pushwoosh API-এর মাধ্যমে আপনি ১০০-এরও বেশি পদ্ধতির একটি বিস্তৃত লাইব্রেরিতে অ্যাক্সেস পান যা আপনাকে সক্ষম করে:

- ব্যক্তিগতকৃত পুশ নোটিফিকেশন পাঠান
- সুনির্দিষ্ট টার্গেটিংয়ের জন্য ব্যবহারকারী সেগমেন্ট তৈরি, আমদানি, রপ্তানি এবং পরিচালনা করুন
- ব্যাচে ব্যবহারকারী/ডিভাইস পরিচালনা করতে বাল্ক API ব্যবহার করুন
- অ্যাপ্লিকেশন কনফিগার করুন
- টার্গেটিং এবং ব্যক্তিগতকরণ উন্নত করতে ব্যবহারকারীর ইভেন্টগুলি ট্র্যাক করুন এবং ব্যবহারকারীদের ট্যাগ যোগ করুন
- প্রিসেট, ট্যাগ, ইভেন্ট, অ্যাপ্লিকেশন ইত্যাদির মতো Pushwoosh এন্টিটি তৈরি এবং পরিচালনা করুন।
- API-এর মাধ্যমে Pushwoosh Customer Journey শুরু করুন
- Customer Journey এবং পুশ/ইমেল/এসএমএস ক্যাম্পেইনের উপর ব্যাপক পরিসংখ্যান পুনরুদ্ধার করুন।
- ব্যবহারকারীরা নির্দিষ্ট ভৌগলিক এলাকায় প্রবেশ বা প্রস্থান করার সময় অবস্থান-ভিত্তিক নোটিফিকেশন পাঠাতে জিওফেন্সিং প্রয়োগ করুন
- Pushwoosh-এর সাথে নির্বিঘ্নে তৃতীয় পক্ষের পরিষেবাগুলি একীভূত করুন

উপলব্ধ পদ্ধতিগুলির সম্পূর্ণ পরিসর অন্বেষণ করতে এবং Pushwoosh API-এর ব্যাপক ক্ষমতাগুলি আবিষ্কার করতে, অনুগ্রহ করে [API পদ্ধতি রেফারেন্স সূচী](/bn/developer/api-reference/api-methods-reference-index) দেখুন।

## প্রমাণীকরণ
 
Pushwoosh API অনুরোধ প্রমাণীকরণের জন্য API টোকেন ব্যবহার করে। দুই ধরনের টোকেন আছে: [**সার্ভার**](/bn/developer/api-reference/api-access-token/#server-api-token) এবং [**ডিভাইস**](/bn/developer/api-reference/api-access-token/#device-api-token), প্রতিটি নির্দিষ্ট API স্কোপের জন্য ব্যবহৃত হয়।

প্রতিটি Pushwoosh অ্যাকাউন্টের সাথে Pushwoosh ডেমো অ্যাপের জন্য তৈরি একটি ডিফল্ট API অ্যাক্সেস টোকেন আসে। আপনি Pushwoosh কন্ট্রোল প্যানেলে আপনার API টোকেন দেখতে, তৈরি করতে এবং পরিচালনা করতে পারেন।
<LinkCard title="আরও জানুন" href="/developer/api-reference/api-access-token/" />


## রেট লিমিট

রেট লিমিট হল একটি নির্দিষ্ট সময়ের মধ্যে API কতগুলি অনুরোধ গ্রহণ করতে পারে তার সংখ্যা। যদিও Pushwoosh-এর বেশিরভাগ API অনুরোধ সীমিত নয়, [`/createMessage`](/bn/developer/api-reference/messages-api/#createmessage) এবং সমতুল্য [Messaging API v2 `Notify`](/bn/developer/api-reference/messaging-api-v2/notify/) অনুরোধগুলি সমস্ত ব্যবহারকারীর জন্য পরিষেবার গুণমান নিশ্চিত করতে প্রতি মিনিটে ৬০০-তে সীমাবদ্ধ।

## অনুরোধ

নিরাপদ ডেটা ট্রান্সফার নিশ্চিত করার জন্য সমস্ত API অনুরোধের জন্য HTTPS বাধ্যতামূলক।

## প্রতিক্রিয়া

Pushwoosh API সাধারণত JSON প্রতিক্রিয়া প্রদান করে।

### সফলতা এবং ত্রুটি কোড

#### সফলতা কোড

যখন আপনার API অনুরোধ সফলভাবে প্রক্রিয়া করা হয়, তখন আপনি প্রতিক্রিয়ার অংশ হিসাবে একটি সফলতা কোড পাবেন।
	
| HTTP স্ট্যাটাস কোড <div style="width:100px"></div> | স্ট্যাটাস বার্তা | বিবরণ |
|------------------|----------------|-------------|
| 200              | OK             | Pushwoosh সফলভাবে অনুরোধটি প্রক্রিয়া করেছে |

অনুগ্রহ করে মনে রাখবেন যে যখন আপনি একটি HTTP 200 প্রতিক্রিয়া পান, তার মানে হল আপনার অনুরোধটি বোঝা গেছে এবং সফলভাবে প্রক্রিয়া করা হয়েছে, কিন্তু এটি কর্মের সাফল্যের নিশ্চয়তা দেয় না। তাই কর্মের সাফল্য নির্ধারণ করতে ত্রুটি বা সতর্কবার্তা (অ্যাক্সেস ডিনাইড, অ্যাপ্লিকেশন নট ফাউন্ড, ইনভ্যালিড API কী, ইত্যাদি) পরীক্ষা করে দেখুন।
	
| স্ট্যাটাস কোড <div style="width:100px"></div>  | স্ট্যাটাস বার্তা |
|-------------|----------------|
| 200         | সতর্কবার্তা: আপনি সাবস্ক্রাইবার সীমাতে পৌঁছেছেন। পুশ বার্তা শুধুমাত্র ১টি র‍্যান্ডম ডিভাইসে পাঠানো হবে |
| 200         | সতর্কবার্তা: আপনি আপনার বর্তমান সাবস্ক্রিপশন প্ল্যানে অনুমোদিত সক্রিয় ডিভাইসের সংখ্যা অতিক্রম করেছেন। |
| 210         | অ্যাক্সেস ডিনাইড বা অ্যাপ্লিকেশন পাওয়া যায়নি |
| 210         | অ্যাপ্লিকেশন পাওয়া যায়নি |
| 210         | অ্যাপ্লিকেশন সাসপেন্ড করা হয়েছে |
| 210         | অ্যাকাউন্ট পাওয়া যায়নি |
| 210         | অ্যাকাউন্ট সাসপেন্ড করা হয়েছে |
| 210         | সাসপেন্ড করা অ্যাকাউন্ট ডিভাইস ফিল্টারেশন ব্যবহার করতে পারে না |
| 210         | API টোকেন বা অ্যাপ্লিকেশন সেট করা নেই |
| 210         | অনুগ্রহ করে অন্তত একটি প্ল্যাটফর্ম নির্বাচন করুন |
| 210         | অবৈধ API টোকেন: অ্যাকাউন্ট পাওয়া যায়নি |
| 210         | কোনো অ্যাপ্লিকেশন বা গ্রুপ কোড দেওয়া হয়নি |
| 210         | API টোকেন বা অ্যাপ্লিকেশন বা অ্যাকাউন্ট সেট করা নেই |

#### ত্রুটি কোড

যদি আপনার অনুরোধটি সঠিকভাবে ফর্ম্যাট করা না হয়, প্রক্রিয়াকরণে সমস্যা হয়, বা অন্য কোনো ত্রুটির সম্মুখীন হয়, Pushwoosh আপনাকে সমস্যার প্রকৃতি নির্দেশ করে একটি ত্রুটি কোড পাঠাবে, যা আপনাকে সমস্যা সমাধান করতে এবং কার্যকরভাবে সমস্যাটি মোকাবেলা করতে সাহায্য করবে।
	
| HTTP স্ট্যাটাস কোড <div style="width:100px"></div>| স্ট্যাটাস বার্তা | বিবরণ |
|------------------|----------------|-------------|
| 400              | খারাপ অনুরোধ    | খারাপ সিনট্যাক্সের কারণে অনুরোধটি পূরণ করা যাবে না |
| 401              | অননুমোদিত   | প্রমাণীকরণ ব্যর্থ হয়েছে বা প্রদান করা হয়নি |
| 403              | টোকেন সীমাবদ্ধতা এই অপারেশনটি নিষিদ্ধ করে। | আপনার অ্যাক্সেস টোকেনের অনুরোধ করা কাজটি সম্পাদন করার জন্য প্রয়োজনীয় অনুমতি নেই। এটি ঠিক করতে, Pushwoosh কন্ট্রোল প্যানেলে আপনার অ্যাক্সেস টোকেনের অনুমতিগুলি পর্যালোচনা করুন এবং আপনি যে নির্দিষ্ট অপারেশনটি করতে চান তার প্রয়োজনীয়তার সাথে মেলাতে প্রয়োজন অনুযায়ী সেগুলি সামঞ্জস্য করুন। |
| 404              | রিসোর্স পাওয়া যায়নি | নির্দেশ করে যে অনুরোধ করা রিসোর্স, যেমন একটি অ্যাপ, সার্ভারে খুঁজে পাওয়া যায়নি বা বিদ্যমান নেই। |
| 500              | অভ্যন্তরীণ ত্রুটি | API অনুরোধ প্রক্রিয়া করার সময় সার্ভারে একটি অপ্রত্যাশিত সমস্যা বা ত্রুটি ছিল। |