---
title: کلیدهای API: ساخت، چرخش و ابطال | Stard API
url: https://stard-market.ir/docs/api-keys
markdown: https://stard-market.ir/docs/api-keys.md
language: fa
updated: 2026-11-18
description: کلیدها برای هر پروژه و محیط جدا ساخته می‌شوند، scope و سقف نرخ و تاریخ انقضا دارند و فقط هش آن‌ها ذخیره می‌شود.
---

# کلیدهای API: ساخت، چرخش و ابطال

> کلیدها برای هر پروژه و محیط جدا ساخته می‌شوند، scope و سقف نرخ و تاریخ انقضا دارند و فقط هش آن‌ها ذخیره می‌شود.

## قالب کلید

`sk_live_` یا `sk_test_` و ۴۰ کاراکتر تصادفی (حدود ۲۳۸ بیت). Stard فقط HMAC کلید را نگه می‌دارد؛ حتی پشتیبانی Stard هم نمی‌تواند کلید تو را ببیند. اگر گمش کردی، کلید تازه بساز.

## Scopeها

| scope | اجازه |
|---|---|
| `products:read` | محصولات، دسته‌ها، مزایده‌ها، آمار بازار |
| `prices:read` | قیمت استارز، TON، دلار، پریمیوم و محصولات |
| `orders:read` | خواندن سفارش‌های همین پروژه |
| `orders:write` | ثبت و لغو سفارش (در live با پول واقعی) |
| `wallet:read` | موجودی و تراکنش‌ها |
| `wallet:write` | تبدیل تومان↔TON و برداشت TON به کیف پول وصل‌شده (پیش‌فرض نیست؛ صریحاً انتخاب کن) |
| `webhooks:read` | خواندن رویدادها |

اصل کمترین دسترسی: کلیدی که فقط قیمت نشان می‌دهد نباید `orders:write` داشته باشد.

## چرخش (rotate)

چرخش یک کلید تازه با همان تنظیمات می‌سازد. کلید قبلی یا فوراً باطل می‌شود یا تا مهلتی که تعیین می‌کنی (حداکثر ۷۲ ساعت) کار می‌کند تا بتوانی بدون قطعی سرویس، کلید را در سرورهایت عوض کنی.

## ابطال

ابطال فوری است؛ درخواست بعدی با آن کلید `401 api_key_revoked` می‌گیرد. اگر کلید لو رفت، اول ابطال، بعد بررسی لاگ‌ها.
