---
title: SDKها: JavaScript، Python و PHP | Stard API
url: https://stard-market.ir/docs/sdks
markdown: https://stard-market.ir/docs/sdks.md
language: fa
updated: 2026-11-18
description: کتابخانه‌های رسمی و تک‌فایلی Stard API بدون وابستگی خارجی؛ با Idempotency-Key خودکار، تلاش دوباره‌ی امن و بررسی امضای وب‌هوک.
---

# SDKها: JavaScript، Python و PHP

> کتابخانه‌های رسمی و تک‌فایلی Stard API بدون وابستگی خارجی؛ با Idempotency-Key خودکار، تلاش دوباره‌ی امن و بررسی امضای وب‌هوک.

**جواب کوتاه:** سه SDK رسمی تک‌فایلی برای JavaScript/TypeScript، Python و PHP؛ فایل را دانلود کن، با کلید API بساز و مثلاً با `buyStars` استارز بخر.

## دانلود

- [stard.mjs](https://stard-market.ir/developers/sdk/stard.mjs) — Node 18+، Deno، Bun و edge (ESM، بدون وابستگی)
- [stard.py](https://stard-market.ir/developers/sdk/stard.py) — Python 3.8+ (فقط کتابخانه‌ی استاندارد)
- [Stard.php](https://stard-market.ir/developers/sdk/Stard.php) — PHP 7.4+ با ext-curl

```bash
curl -O https://stard-market.ir/developers/sdk/stard.mjs
curl -O https://stard-market.ir/developers/sdk/stard.py
curl -O https://stard-market.ir/developers/sdk/Stard.php
```

## استفاده

```javascript
import { Stard } from "./stard.mjs";

const stard = new Stard(process.env.STARD_API_KEY);      // sk_test_… یا sk_live_…
const price = await stard.starsPrice(500);
const order = await stard.buyStars({ quantity: 500, recipient: "@username", metadata: { invoice: "INV-1042" } });
console.log(order.id, order.status);
```

```python
from stard import Stard

stard = Stard(os.environ["STARD_API_KEY"])
price = stard.stars_price(500)
order = stard.buy_stars(quantity=500, recipient="@username", metadata={"invoice": "INV-1042"})
print(order["id"], order["status"])
```

```php
<?php
require 'Stard.php';

$stard = new Stard\Client(getenv('STARD_API_KEY'));
$price = $stard->starsPrice(500);
$order = $stard->buyStars(500, '@username', null, ['invoice' => 'INV-1042']);
echo $order['id'], ' ', $order['status'];
```

## چه چیزهایی آماده است

- همه‌ی endpointهای v1: قیمت‌ها، استارز، پریمیوم، محصولات، کیف پول، تراکنش‌ها و سفارش (ثبت، پیگیری، لغو).
- `Idempotency-Key` خودکار برای هر POST؛ تلاش دوباره روی 429 و 5xx با همان کلید، پس سفارش تکراری ساخته نمی‌شود.
- خطاهای ساختاریافته (`code`، `param`، `request_id`).
- `verifyWebhook` / `verify_webhook` برای [وب‌هوک‌ها](https://stard-market.ir/docs/webhooks).
- `pay_currency` اختیاری: اگر نفرستی، منبع پیش‌فرض [کیف پول API](https://stard-market.ir/docs/wallet) (TON یا تومان) استفاده می‌شود.

*⚠️*

SDK فقط سمت سرور. کلید API را هرگز در مرورگر، اپ موبایل یا مخزن عمومی نگذار.
