HTTP বলতে পারে এমন সবকিছুর জন্য iOS Live Activity API
PushWard একটি iOS Live Activity API: একটিমাত্র HTTP রিকোয়েস্ট পাঠান, আর সেটি iPhone Lock Screen ও Dynamic Island-এ লাইভ দেখা যায়, রিয়েল-টাইমে আপডেট হয় এবং কাজ শেষ হলে নিজে থেকেই সরে যায়। ActivityKit কোড নেই, Xcode নেই, আপনার দিক থেকে App Store রিভিউও নেই।
Live Activity কী?
Live Activity হলো iOS-এর একটি ফিচার, যা Lock Screen-এ, Dynamic Island-এ এবং StandBy-তে লাইভ, এক নজরে বোঝা যায় এমন তথ্য দেখায় — প্রাপককে কখনো কোনো অ্যাপ খুলতে হয় না। একবার দেখা দিয়ে তালিকায় হারিয়ে যাওয়া পুশ নোটিফিকেশনের মতো নয়, Live Activity পিন করা থাকে এবং রিয়েল-টাইমে আপডেট হয়: ধাপে ধাপে এগোনো একটি বিল্ড, কাউন্টডাউন করা একটি টাইমার, কাছে চলে আসা একটি ডেলিভারি। PushWard একটিমাত্র HTTP রিকোয়েস্টকে ঠিক এটিতেই বদলে দেয়।
API যেভাবে কাজ করে
একটি অ্যাক্টিভিটি তৈরি করুন, শুরু করুন, আপডেট করুন এবং শেষ করুন — সবই আপনার ইন্টিগ্রেশন কী দিয়ে PushWard-এর REST API-এর মাধ্যমে। HTTP রিকোয়েস্ট পাঠাতে পারে এমন যেকোনো সার্ভিস ঠিক করতে পারে মানুষ এক নজরে কী দেখবে। APNs সার্টিফিকেট নেই, ক্লায়েন্ট কোড লেখারও কিছু নেই; ডেলিভারি PushWard সামলায় Apple Push Notification service-এর মাধ্যমে।
# 1. Create an activity
curl -X POST https://api.pushward.app/activities \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "slug": "deploy", "name": "Deploy to production" }'
# 2. Start the Live Activity on the Lock Screen
curl -X PATCH https://api.pushward.app/activities/deploy \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/merge-patch+json" \
-d '{ "state": "ongoing", "content": {
"template": "generic", "progress": 0.2,
"state": "Building...", "accent_color": "cyan"
} }'
# 3. End it when the task is done
curl -X PATCH https://api.pushward.app/activities/deploy \
-H "Authorization: Bearer hlk_YOUR_KEY" \
-H "Content-Type: application/merge-patch+json" \
-d '{ "state": "ended", "content": {
"template": "generic", "progress": 1, "state": "Deployed"
} }'প্রতিটি ধরনের আপডেটের জন্য একটি টেমপ্লেট
ভিন্ন ভিন্ন কাজের জন্য তৈরি Live Activity টেমপ্লেট থেকে বেছে নিন — একটি জেনেরিক প্রগ্রেস বার, কাউন্টডাউন, ধাপের সিকোয়েন্স, অ্যালার্ট, গেজ, টাইমলাইন স্পার্কলাইন, টাইলের বোর্ড কিংবা লাইভ ইভেন্ট লগ। প্রতিটির লেআউট Lock Screen ও Dynamic Island-এর জন্য টিউন করা।
আপনার স্ট্যাকের সঙ্গে কাজ করে
যে টুলগুলো আপনি ইতিমধ্যে চালাচ্ছেন, সেগুলো থেকেই সরাসরি Live Activities পাঠান। রেডিমেড ব্রিজ আর হোস্টেড webhook relay কভার করে Grafana অ্যালার্ট, Home Assistant অটোমেশন, GitHub Actions, SABnzbd ডাউনলোড, Bambu Lab প্রিন্ট, ArgoCD সিঙ্ক এবং JSON পাঠাতে পারে এমন আর সবকিছু।
iOS Live Activity API ব্যবহার করে দেখুন
playground-এ একটি সিমুলেটেড iPhone-এ Live Activity পৌঁছাতে দেখুন, অথবা গেটিং-স্টার্টেড গাইড পড়ে কয়েক মিনিটে curl দিয়ে আপনার প্রথমটি পাঠান।