وبسرویس (API) اکشن سین

شروع

وبسرویس رایگان فعال می‌شود؛ از بخش «وبسرویس (API)» در پنل کلیدت را بگیر. موجودی وبسرویس جدا از موجودی پنل است و شارژش هم از همان صفحه انجام می‌شود.

دو شکل آدرس هر دو کار می‌کنند. شکل اول همان چیزی است که مشتری‌های قدیمی استفاده می‌کردند و علامت سؤال ندارد؛ شکل دوم استاندارد است و با هر کتابخانه‌ای راحت ساخته می‌شود:

https://actionseen.ir/api/key=API_KEY&action=balance
https://actionseen.ir/api/?key=API_KEY&action=balance

سرویس‌ها و قیمت

هر سکه ۰٫۳۸ تومان است. شارژ از ۵۰۰٬۰۰۰ تا ۱۰۰٬۰۰۰٬۰۰۰ سکه ممکن است — یعنی از ۱۹۰٬۰۰۰ تومان.

فهرست سرویس‌ها

تنها درخواستی که کلید لازم ندارد.

https://actionseen.ir/api/action=services

ثبت سفارش بازدید

اگر هیچ‌کدام از startdelay، interval و vpi را نفرستی، سفارش با حداکثر سرعت ثبت می‌شود. اگر فقط بعضی‌شان را بفرستی، بقیه مقدار پیش‌فرض می‌گیرند و خطا نمی‌گیری. مثلاً با فرستادن تنها startdelay=30 سفارش نیم‌ساعت بعد شروع می‌شود و بقیه‌اش با حداکثر سرعت می‌رود.

https://actionseen.ir/api/key=API_KEY&action=view&link=https://t.me/channel/123&quantity=1000&lastxpost=5

ثبت سفارش ری‌اکشن

پارامتر text باید دقیقاً یکی از ایموجی‌های زیر باشد. هر چیز دیگری با خطای 422 رد می‌شود. این فهرست همان چیزی است که تلگرام برای ری‌اکشن می‌پذیرد.

👍 👎 ❤️ 🔥 🥰 👏 😁 🤔 🤯 😱 🤬 😢 🎉 🤩 🤮 💩 🙏 👌 🕊 🤡 🥱 🥴 😍 🐳 ❤️‍🔥 🌚 🌭 💯 🤣 ⚡️ 🍌 🏆 💔 🤨 😐 🍓 🍾 💋 🖕 😈 😴 😭 🤓 👻 👨‍💻 👀 🎃 🙈 😇 😨 🤝 ✍️ 🤗 🫡 🎅 🎄 ☃️ 💅 🤪 🗿 🆒 💘 🙉 🦄 😘 💊 🙊 😎 👾 🤷‍♂️ 🤷 🤷‍♀️ 😡

⚠️ ایموجی را در آدرس کدگذاری درصدی کن (%F0%9F%94%A5 برای 🔥). این تنها پارامتری است که کدگذاری می‌خواهد؛ بقیه — به‌ویژه link — باید خام بمانند.

https://actionseen.ir/api/key=API_KEY&action=reaction&link=https://t.me/channel/123&quantity=50&text=%F0%9F%94%A5&speed=1

ثبت سفارش لایک و رأی نظرسنجی

⚠️ سطر و ستون از یک شمرده می‌شوند، نه از صفر. مستندات خیلی قدیمی صفر می‌گفت و آن غلط بود. ضمناً پست کانال خصوصی (t.me/c/…) برای لایک پشتیبانی نمی‌شود.

https://actionseen.ir/api/key=API_KEY&action=like&link=https://t.me/channel/123&quantity=25&row=1&column=2&speed=1

پاسخ ثبت سفارش

{
  "order": "AV12ab34cd",
  "link": "https://t.me/channel/123",
  "quantity": 1000,
  "charge": 1000,
  "currency": "Coin",
  "status": "In progress"
}

وضعیت سفارش

همان action سرویس، ولی به‌جای link و quantity پارامتر order را بفرست:

https://actionseen.ir/api/key=API_KEY&action=view&order=AV12ab34cd

وضعیت یکی از این‌هاست: pending، In progress، Done، Canceled، Partial. مقدار remains یعنی چقدر سکه بابت بخش انجام‌نشده برگشته است.

لغو سفارش

https://actionseen.ir/api/key=API_KEY&action=cancel&order=AV12ab34cd

پاسخ: {"cancel request":"Sent"}. سفارشی که هنوز شروع نشده فوری لغو می‌شود و سکه‌اش همان لحظه برمی‌گردد؛ سفارش در جریان به وب‌سرویس اعلام می‌شود و سکه‌ی بخش انجام‌نشده بعداً عودت داده می‌شود.

موجودی

https://actionseen.ir/api/key=API_KEY&action=balance

{"balance": 1250000, "used": 480000, "currency": "Coin"}

خطاها

هر خطا با کد وضعیت HTTP مناسب و همین شکل برمی‌گردد. متن خطا همیشه انگلیسی است:

{"error": "Invalid API key"}

متن‌هایی که ممکن است در error ببینی: