SDKها: JavaScript، Python و PHP
کتابخانههای رسمی و تکفایلی Stard API بدون وابستگی خارجی؛ با Idempotency-Key خودکار، تلاش دوبارهی امن و بررسی امضای وبهوک.
جواب کوتاه: سه SDK رسمی تکفایلی برای JavaScript/TypeScript، Python و PHP؛ فایل را دانلود کن، با کلید API بساز و مثلاً با
buyStars استارز بخر.دانلود
- stard.mjs — Node 18+، Deno، Bun و edge (ESM، بدون وابستگی)
- stard.py — Python 3.8+ (فقط کتابخانهی استاندارد)
- Stard.php — PHP 7.4+ با ext-curl
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استفاده
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);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
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برای وبهوکها.pay_currencyاختیاری: اگر نفرستی، منبع پیشفرض کیف پول API (TON یا تومان) استفاده میشود.
⚠️
SDK فقط سمت سرور. کلید API را هرگز در مرورگر، اپ موبایل یا مخزن عمومی نگذار.
