کلید API ربات تلگرام
با این کلید، ربات تلگرام شما میتواند موجودی را ببیند، لیست کارتها را بگیرد و کد بفروشد. کلید فقط یکبار نمایش داده میشود.
مستندات کوتاه برای ربات
GET /api/bot/me هدر: x-api-key
GET /api/bot/products
POST /api/bot/orders {"productId":"p100k","quantity":1,"externalOrderId":"order-123"}
GET (اختیاری) همان درخواست را دوباره بفرستید؛ اگر externalOrderId تکراری باشد پیام duplicate برمیگردد (کدها فقط یکبار).
وبهوک (Webhook)
رویدادهای سفارش، مصرف کد، برداشت و شارژ اعتبار را به آدرس شما ارسال میکنیم. امضا: HMAC-SHA256 روی timestamp.body با هدرهای x-koshe-signature و x-koshe-timestamp.
آخرین تحویلها و خطاها
ارسال ناموفق بهصورت خودکار با فاصلهٔ افزایشی تلاش میشود؛ بعد از ۶ تلاش در صف dead-letter قرار میگیرد و از همین جدول قابل ارسال مجدد است.