জিওজোনস এপিআই

getNearestZone

এসডিকে থেকে অভ্যন্তরীণভাবে কল করা হয়। নিকটতম জিওজোনের প্যারামিটার এবং এর দূরত্ব পুনরুদ্ধার করে। জিও পুশ নোটিফিকেশনের জন্য ডিভাইসের অবস্থানও রেকর্ড করে।

POST https://api.pushwoosh.com/json/1.3/getNearestZone

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	টাইপ	প্রয়োজনীয়	বিবরণ
application	string	হ্যাঁ	Pushwoosh অ্যাপ্লিকেশন কোড
hwid	string	হ্যাঁ	/registerDevice রিকোয়েস্টে ব্যবহৃত হার্ডওয়্যার ডিভাইস আইডি।
lat	string	হ্যাঁ	ডিভাইসের অক্ষাংশ।
lng	string	হ্যাঁ	ডিভাইসের দ্রাঘিমাংশ।

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "application": "APPLICATION_CODE",
    "hwid": "HWID",
    "lat": 10.12345,
    "lng": 28.12345
  }
}

পিএইচপি উদাহরণ

// দেখুন http://gomoob.github.io/php-pushwoosh/get-nearest-zone.html

use Gomoob\Pushwoosh\Model\Request\GetNearestZoneRequest;

// রিকোয়েস্ট ইনস্ট্যান্স তৈরি করে
$request = GetNearestZoneRequest::create()
    ->setHwid('HWID')
    ->setLat(10.12345)
    ->setLng(28.12345);

// '/getNearestZone' ওয়েব সার্ভিস কল করুন
$response = $pushwoosh->getNearestZone($request);

if ($response->isOk()) {
    print 'জোনের নাম : ' . $response->getResponse()->getName();
    print 'অক্ষাংশ : ' . $response->getResponse()->getLat();
    print 'দ্রাঘিমাংশ : ' . $response->getResponse()->getLng();
    print 'পরিসীমা : ' . $response->getResponse()->getRange();
    print 'দূরত্ব : ' . $response->getResponse()->getDistance();
} else {
    print 'দুঃখিত, অপারেশনটি ব্যর্থ হয়েছে :-(';
    print 'স্ট্যাটাস কোড : ' . $response->getStatusCode();
    print 'স্ট্যাটাস মেসেজ : ' . $response->getStatusMessage();
}

addGeoZone

একটি নির্দিষ্ট অ্যাপে একটি জিওজোন যোগ করে।

POST https://api.pushwoosh.com/json/1.3/addGeoZone

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	টাইপ	প্রয়োজনীয়	বিবরণ
auth	string	হ্যাঁ	Pushwoosh কন্ট্রোল প্যানেল থেকে এপিআই অ্যাক্সেস টোকেন।
application	string	হ্যাঁ	Pushwoosh অ্যাপ্লিকেশন কোড
geozones	array	হ্যাঁ	একটি JSON অ্যারে হিসাবে জিওজোন প্যারামিটার।
geozones.name	string	হ্যাঁ	জিওজোনের নাম।
geozones.lat	string	হ্যাঁ	জিওজোনের অক্ষাংশ।
geozones.lng	string	হ্যাঁ	জিওজোনের দ্রাঘিমাংশ।
geozones.cooldown	integer	হ্যাঁ	একটি নোটিফিকেশন পাঠানোর পরে নীরব সময় (সেকেন্ডে)।
geozones.range	integer	হ্যাঁ	জিওজোনের পরিসীমা মিটারে। সর্বনিম্ন ৫০।
geozones.content	string or object	presetCode খালি থাকলে প্রয়োজনীয়।	জিওজোন মেসেজের বিষয়বস্তু।
geozones.presetCode	string	content খালি থাকলে প্রয়োজনীয়।	content এর পরিবর্তে ব্যবহার করার জন্য পুশ প্রিসেট।
geozones.cluster	string	না	জিওজোন থেকে একটি ক্লাস্টার আনবাইন্ড করতে null উল্লেখ করুন।
geozones.campaign	string	না	জিওজোন থেকে একটি ক্যাম্পেইন আনবাইন্ড করতে null উল্লেখ করুন। যদি বাদ দেওয়া হয়, ক্যাম্পেইনের মান অপরিবর্তিত থাকবে। দ্রষ্টব্য: প্রিসেটের ক্যাম্পেইনের চেয়ে এর অগ্রাধিকার বেশি।
geozones.timetable	object	না	টাইমটেবিল ইন্টারভাল সেট করে।

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "auth": "yxoPUlwqm............pIyEX4H",  // Pushwoosh কন্ট্রোল প্যানেল থেকে এপিআই অ্যাক্সেস টোকেন
    "application": "XXXXX-XXXXX",            // Pushwoosh অ্যাপ্লিকেশন কোড
    "geozones": [{
      "name": "Statue of George",            // প্রয়োজনীয়। জিওজোনের নাম।
      "lat": "40.70087797",                   // প্রয়োজনীয়। জিওজোনের অক্ষাংশ।
      "lng": "-73.931851387",                 // প্রয়োজনীয়। জিওজোনের দ্রাঘিমাংশ।
      "cooldown": 60,                         // সেকেন্ডে, প্রয়োজনীয়। একটি নোটিফিকেশন পাঠানোর পরে নীরব সময়
      "range": 50,                            // মিটারে, সর্বনিম্ন ৫০, প্রয়োজনীয়। জিওজোনের পরিসীমা।
      "content": "Lorem ipsum dolor sit amet,
       consectetur adipiscing elit.",         // অথবা অবজেক্ট
      "presetCode": "AAAAA-BBBBB",            // ঐচ্ছিক। কন্টেন্টের পরিবর্তে পুশ প্রিসেট ব্যবহার করা যেতে পারে
      "cluster": "GEOZONE CLUSTER CODE",      // ঐচ্ছিক। ক্লাস্টারের কুলডাউন পিরিয়ড প্রয়োগ করা হবে
      "campaign": "CAMPAIGN_CODE",            // ঐচ্ছিক। জিওজোন থেকে ক্যাম্পেইন আনবাইন্ড করতে null উল্লেখ করুন
      "timetable": {                          // ঐচ্ছিক
        "timezone": 1234,                     // সেকেন্ডে
        "Mon": [                              // উপলব্ধ দিন: Mon, Tue, Wed, Thu, Fri, Sat, Sun। পুশ পাঠানো
          {
            "start": "04:11",
            "stop": "12:00"
          }
        ],
        "Sun": [
          {                                    // এক বা দুটি ইন্টারভাল
            "start": "01:11",
            "stop": "17:00"
          },
          {
            "start": "18:01",
            "stop": "23:59"
          }
        ]
      }
    }]
  }
}

updateGeoZone

জিওজোনের বৈশিষ্ট্য আপডেট করে।

POST https://api.pushwoosh.com/json/1.3/updateGeoZone

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	টাইপ	প্রয়োজনীয়	বিবরণ
auth	string	হ্যাঁ	Pushwoosh কন্ট্রোল প্যানেল থেকে এপিআই অ্যাক্সেস টোকেন।
geoZoneId	string	হ্যাঁ	/addGeoZone রিকোয়েস্ট থেকে জিওজোন আইডি।
name	string	না	নতুন জিওজোনের নাম।
cooldown	integer	না	আপডেট করার জন্য কুলডাউন, সেকেন্ডে।
status	integer	না	0 - নিষ্ক্রিয়, 1 - সক্রিয়।
content	string	না	জিওজোন পুশ নোটিফিকেশনের জন্য কন্টেন্ট। presetCode এর সাথে ব্যবহার করা যাবে না।
cluster	string	না	নতুন ক্লাস্টারের নাম। জিওজোন থেকে ক্লাস্টার আনবাইন্ড করতে null উল্লেখ করুন।
campaign	string	না	নতুন ক্যাম্পেইন আইডি। জিওজোন থেকে ক্যাম্পেইন আনবাইন্ড করতে null উল্লেখ করুন। যদি বাদ দেওয়া হয়, ক্যাম্পেইনের মান পরিবর্তন হবে না। প্রিসেটের ক্যাম্পেইনের চেয়ে এর অগ্রাধিকার বেশি।
lat	number	না	জিওজোনের অক্ষাংশ।
lng	number	না	জিওজোনের দ্রাঘিমাংশ।
range	integer	না	নতুন পরিসীমা মিটারে।
timetable	object	না	জিওজোন টাইমটেবিল। আরও তথ্যের জন্য নিচে দেখুন।

---

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "auth": "yxoPUlwqm............pIyEX4H",  // প্রয়োজনীয়, Pushwoosh কন্ট্রোল থেকে এপিআই অ্যাক্সেস টোকেন
    "geoZoneId": 100016750,                  // প্রয়োজনীয়, /addGeoZone মেথড থেকে
    "name": "new geozone name",              // ঐচ্ছিক
    "cooldown": 222,                         // সেকেন্ডে, ঐচ্ছিক
    "status": 0,                             // ঐচ্ছিক, 0 - নিষ্ক্রিয়, 1 - সক্রিয়
    "presetCode": "BBBBB-AAAAA",             // ঐচ্ছিক, "content" এর সাথে ব্যবহার করা যাবে না
    "content": "new geozone content",        // ঐচ্ছিক, "presetCode" এর সাথে ব্যবহার করা যাবে না
    "cluster": "GEOZONE CLUSTER CODE",       // ঐচ্ছিক। জিওজোন থেকে ক্লাস্টার আনবাইন্ড করতে null উল্লেখ করুন
    "campaign": "CAMPAIGN_CODE",             // ঐচ্ছিক। জিওজোন থেকে ক্যাম্পেইন আনবাইন্ড করতে null উল্লেখ করুন
    "lat": 10.56,                            // ঐচ্ছিক, জিওজোনের অক্ষাংশ
    "lng": 12.523,                           // ঐচ্ছিক, জিওজোনের দ্রাঘিমাংশ
    "range": 500,                            // ঐচ্ছিক, জিওজোনের পরিসীমা
    "timetable": {                           // ঐচ্ছিক
      "timezone": 1234,                      // সেকেন্ডে
      "Mon": [                               // উপলব্ধ দিন: Mon, Tue, Wed, Thu, Fri, Sat, Sun। পুশ পাঠানো
        {
          "start": "04:11",
          "stop": "12:00"
        }
      ],
      "Sun": [
        {                                    // এক বা দুটি ইন্টারভাল
          "start": "01:11",
          "stop": "17:00"
        },
        {
          "start": "18:01",
          "stop": "23:59"
        }
      ]
    }
  }
}

deleteGeoZone

অ্যাপ থেকে জিওজোন সরিয়ে দেয়।

POST https://api.pushwoosh.com/json/1.3/deleteGeoZone

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	টাইপ	প্রয়োজনীয়	বিবরণ
auth	string	হ্যাঁ	Pushwoosh কন্ট্রোল প্যানেল থেকে এপিআই অ্যাক্সেস টোকেন।
application	string	হ্যাঁ	Pushwoosh অ্যাপ্লিকেশন কোড
geozones	string	হ্যাঁ	সরানোর জন্য জিওজোনের আইডিগুলির অ্যারে বা একটি একক আইডি।

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "auth": "yxoPUlwqm............pIyEX4H",  // প্রয়োজনীয়, Pushwoosh কন্ট্রোল থেকে এপিআই অ্যাক্সেস টোকেন
    "application": "XXXXX-XXXXX",            // প্রয়োজনীয়, Pushwoosh অ্যাপ্লিকেশন কোড
    "geozones": [550, 526]                   // প্রয়োজনীয়, জিওজোন আইডি
  }
}

addGeoZoneCluster

অ্যাপে জিওজোন ক্লাস্টার যোগ করে।

POST https://api.pushwoosh.com/json/1.3/addGeoZoneCluster

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	টাইপ	প্রয়োজনীয়	বিবরণ
auth	string	হ্যাঁ	Pushwoosh কন্ট্রোল প্যানেল থেকে এপিআই অ্যাক্সেস টোকেন।
application	string	হ্যাঁ	Pushwoosh অ্যাপ্লিকেশন কোড
name	string	হ্যাঁ	ক্লাস্টারের নাম।
cooldown	integer	হ্যাঁ	একজন একক ব্যবহারকারী জিওজোন ক্লাস্টার থেকে একই মেসেজ পাওয়ার আগে একটি বিলম্ব, সেকেন্ডে।

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "auth": "yxoPUlwqm............pIyEX4H",  // প্রয়োজনীয়, Pushwoosh কন্ট্রোল থেকে এপিআই অ্যাক্সেস টোকেন
    "application": "XXXXX-XXXXX",            // প্রয়োজনীয়, Pushwoosh অ্যাপ্লিকেশন কোড
    "name": "Raccoon city",                  // প্রয়োজনীয়, ক্লাস্টারের নাম
    "cooldown": 3210                         // প্রয়োজনীয়, সেকেন্ডে
  }
}

deleteGeoZoneCluster

অ্যাপ থেকে একটি জিওজোন ক্লাস্টার সরিয়ে দেয়।

POST https://api.pushwoosh.com/json/1.3/deleteGeoZoneCluster

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	টাইপ	প্রয়োজনীয়	বিবরণ
auth	string	হ্যাঁ	Pushwoosh কন্ট্রোল প্যানেল থেকে এপিআই অ্যাক্সেস টোকেন।
application	string	হ্যাঁ	Pushwoosh অ্যাপ্লিকেশন কোড
geoZoneCluster	string	হ্যাঁ	সরানোর জন্য জিওজোন ক্লাস্টারের আইডি।

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "auth": "yxoPUlwqm............pIyEX4H",  // প্রয়োজনীয়, Pushwoosh কন্ট্রোল থেকে এপিআই অ্যাক্সেস টোকেন
    "application": "XXXXX-XXXXX",            // প্রয়োজনীয়, Pushwoosh অ্যাপ্লিকেশন কোড
    "geoZoneCluster": "EA1CE-69405"          // প্রয়োজনীয়, /addGeoZoneCluster রিকোয়েস্ট থেকে প্রাপ্ত ক্লাস্টার আইডি
  }
}

listGeoZones

অ্যাপের জন্য জিওজোনের একটি তালিকা পুনরুদ্ধার করে।

POST https://api.pushwoosh.com/json/1.3/listGeoZones

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	টাইপ	প্রয়োজনীয়	বিবরণ
auth	string	হ্যাঁ	Pushwoosh কন্ট্রোল প্যানেল থেকে এপিআই অ্যাক্সেস টোকেন।
application	string	হ্যাঁ	Pushwoosh অ্যাপ্লিকেশন কোড

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "auth": "yxoPUlwqm............pIyEX4H",  // প্রয়োজনীয়, Pushwoosh কন্ট্রোল থেকে এপিআই অ্যাক্সেস টোকেন
    "application": "XXXXX-XXXXX"             // প্রয়োজনীয়, Pushwoosh অ্যাপ্লিকেশন কোড
  }
}

listGeoZoneClusters

অ্যাপের জন্য জিওজোন ক্লাস্টারের একটি তালিকা পুনরুদ্ধার করে।

POST https://api.pushwoosh.com/json/1.3/listGeoZoneClusters

রিকোয়েস্ট বডি প্যারামিটার

প্যারামিটার	টাইপ	প্রয়োজনীয়	বিবরণ
auth	string	হ্যাঁ	Pushwoosh কন্ট্রোল প্যানেল থেকে এপিআই অ্যাক্সেস টোকেন।
application	string	হ্যাঁ	Pushwoosh অ্যাপ্লিকেশন কোড

রিকোয়েস্টের উদাহরণ

{
  "request": {
    "auth": "yxoPUlwqm............pIyEX4H",  // প্রয়োজনীয়, Pushwoosh কন্ট্রোল থেকে এপিআই অ্যাক্সেস টোকেন
    "application": "XXXXX-XXXXX"             // প্রয়োজনীয়, Pushwoosh অ্যাপ্লিকেশন কোড
  }
}