GemStar Developer Documentation · Swagger / OpenAPI 3.0.4

مستندات یک‌صفحه‌ای API های GemStar

این صفحه شامل مستندات کامل و حرفه‌ای برای دو endpoint اصلی GemStar است: دریافت لیست گیفت‌ها و ارسال گیفت. هر دو API در یک Swagger UI یکپارچه قرار گرفته‌اند تا تست، بررسی schema، احراز هویت و مشاهده نمونه پاسخ‌ها در یک صفحه انجام شود.

Base URL https://api.gemstarbot.xyz
Endpoints 2 عملیات اصلی
Authentication Bearer Token + token field
Formats JSON / Form Data / Query
برای endpoint /gifts می‌توانید توکن را با Authorization: Bearer TOKEN یا از طریق query string بفرستید. برای endpoint /sendgift توکن داخل بدنه درخواست ارسال می‌شود. فیلد gift همان شناسه داخلی Gift از API لیست هدایا است، نه شناسه واقعی تلگرام.