StardDevelopersداشبورد

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);

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

  • همه‌ی endpointهای v1: قیمت‌ها، استارز، پریمیوم، محصولات، کیف پول، تراکنش‌ها و سفارش (ثبت، پیگیری، لغو).
  • Idempotency-Key خودکار برای هر POST؛ تلاش دوباره روی 429 و 5xx با همان کلید، پس سفارش تکراری ساخته نمی‌شود.
  • خطاهای ساختاریافته (code، param، request_id).
  • verifyWebhook / verify_webhook برای وب‌هوک‌ها.
  • pay_currency اختیاری: اگر نفرستی، منبع پیش‌فرض کیف پول API (TON یا تومان) استفاده می‌شود.
⚠️
SDK فقط سمت سرور. کلید API را هرگز در مرورگر، اپ موبایل یا مخزن عمومی نگذار.