مستندات وب سرویس بررسی عضویت کاربر
با استفاده از این وب سرویس، میتوانید بدون ادمین کردن ربات خود در کانال مورد نظر، بررسی کنید که کاربر عضو کانال شما هست یا خیر. با توجه به آسیب پذیری های موجود در سورس ربات ها، همیشه خطر هک شدن ربات و دریافت دسترسی به کانال شما توسط هکر ها وجود دارد. با استفاده از این وب سرویس، کافیست شما ربات سرویس ما (@GetMyChatBot) را ادمین کانال خود کنید و یا با استفاده از معرفی توکن، یک ربات بلااستفاده را
به وب سرویس معرفی کنید و از طریق آن، عضویت کاربران را بررسی کنید.دسترسی به نسخه 2 وب سرویس، از طریق لینک زیر امکان پذیر است:
https://api.ineo-team.ir/getc-v2.php
برای استفاده از این وب سرویس، درخواست ها را باید از طریق متد GET ارسال کنیم.
با استفاده از این درخواست، میتوانید بررسی کنید که کاربر مورد نظر، در کانال/گروه/سوپرگروه شما عضو هستند یا خیر.
برای این کار، نیاز به آیدی عددی یا user_id
کاربر و همچنین با نام کاربری یا آیدی کاربری کانال/گروه/سوپرگروه
مورد نظر نیاز دارید. دقت داشته باشید که برای ارسال درخواست، حتما باید آیدی عددی کاربر را به پارامتر user
ارسال کنید،
اما برای چت مورد نظر، میتوانید نام کاربری یا شناسه عددی کاربری کانال/گروه/سوپرگروه مورد نظر را به پارامتر chat
ارسال کنید.
در صورتی که پارامتر token
خالی باشد، شما باید ربات @GetMyChatBot را در
کانال/گروه/سوپرگروه مورد نظر خود ادمین کنید (نیاز به هیچ دسترسی نیست) تا بررسی توسط این ربات انجام شود، در غیر این صورت،
میتوانید یک ربات بلااستفاده طراحی کنید و آن را ادمین کانال/گروه/سوپرگروه مورد نظر کنید و توکن آن را به پارامتر token
بدهید تا
بررسی توسط ربات شما انجام گردد.
token | اختیاری | توکن ربات جهت بررسی عضویت |
---|---|---|
chat | اجباری | نام کاربری یا آیدی کاربری چت |
user | اجباری | آیدی عددی کاربر مورد نظر |
نمونه ارسال درخواست از طریق لینک:
https://api.ineo-team.ir/getc-v2.php?chat=@iNeoTeam&user=1808503667
https://api.ineo-team.ir/getc-v2.php?chat=1001446452508&user=1808503667
با استفاده از جدول زیر، میتوانید وضعیت و خطا های هر درخواست وب سرویس بررسی عضویت کاربر را بررسی کنید.
لیست کد وضعیت درخواست:
200 - successfully | درخواست به موفقیت ارسال شد. |
---|---|
4001 - parameter_error | پارامترهای اصلی و اجباری وارد نشده اند. |
301 - user_invalid | آیدی عددی کاربر اشتباه است. |
302 - chat_invalid | چت پیدا نشد، ممکن است ربات عضو چت نباشد. |
303 - no_permission | ربات در چت ادمین نیست. |
304 - user_not_found | کاربر عضو/مدیر/سازنده چت نیست. |
در صورتی که کد وضعیت مورد نظر، در جدول بالا نبود، جدول کامل لیست کد وضعیت درخواست ها را مطالعه کنید.
برای استفاده از این وب سرویس، نمونه کد وجود ندارد. استفاده از این وب سرویس، بسیار ساده است.