---
title: پرسش‌های رایج درباره‌ی Stard API
url: https://stard-market.ir/docs/faq
markdown: https://stard-market.ir/docs/faq.md
language: fa
updated: 2026-11-18
description: پاسخ کوتاه و دقیق به پرسش‌های رایج درباره‌ی API، هزینه، احراز هویت و خرید استارز.
---

# پرسش‌های رایج درباره‌ی Stard API

> پاسخ کوتاه و دقیق به پرسش‌های رایج درباره‌ی API، هزینه، احراز هویت و خرید استارز.

## پاسخ‌ها

اگر پاسخ پرسشت اینجا نیست، در [کانال Stard](https://t.me/Stard_market) بپرس.

## پرسش‌های رایج

**Stard API چیست؟**

API رسمی Stard Market که با آن برنامه‌ها می‌توانند قیمت استارز و محصولات تلگرام را بخوانند و سفارش واقعی ثبت کنند.

**آیا Stard API برای خرید استارز تلگرام دارد؟**

بله. `POST /api/v1/orders` با `type=stars`؛ [راهنما](https://stard-market.ir/docs/products/stars).

**چطور کلید API بسازم؟**

در [داشبورد](https://stard-market.ir/developers/dashboard) وارد شو و از بخش کلیدها یک کلید test یا live بساز.

**احراز هویت چطور است؟**

هدر `Authorization: Bearer sk_live_…`؛ کلید هرگز در URL نیاید.

**استفاده از API چقدر هزینه دارد؟**

خود API رایگان است؛ فقط مبلغ سفارش‌ها با همان قیمت فروشگاه از کیف پول کسر می‌شود.

**محیط تست دارد؟**

بله؛ کلیدهای `sk_test_` با ۱۰۰ میلیون تومان موجودی آزمایشی و بدون پول واقعی کار می‌کنند.

**وب‌هوک دارد؟**

بله. از داشبورد توسعه‌دهنده یک آدرس https ثبت کن و رویدادهای order.created، order.processing، order.completed، order.cancelled، order.refunded و order.failed را با امضای HMAC-SHA256 دریافت کن؛ تحویل ناموفق تا ۸ بار با فاصله‌ی افزایشی دوباره فرستاده می‌شود. جزئیات و نمونه‌ی بررسی امضا در /docs/webhooks.

**چه چیزهایی را می‌شود با API خرید؟**

همه‌ی چیزهایی که ربات و مینی‌اپ می‌فروشند: استارز، پریمیوم، گیفت استارزی (با فرستنده‌ی مخفی، پیام با ایموجی پریمیوم و زمان‌بندی)، محصولات فروشگاه، بوست، همه‌ی خدمات کانال (ممبر — حتی با ادمین کردن ربات و آمار ورود/خروج — بازدید، ری‌اکشن، کامنت، ارسال تدریجی…) و ری‌اکشن استارزی؛ همه در live و test.

**پیام خطا انگلیسی هم دارد؟**

بله؛ هر خطا code ماشینی، message فارسی و message_en انگلیسی دارد.

**سقف درخواست چقدر است؟**

پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید؛ هدرهای X-RateLimit وضعیت را می‌گویند.
