API توسعه‌دهندگان بایداکس

🧪 تست آنلاین API

درخواست واقعی به /api/v1 — همان مسیری که کد شما استفاده می‌کند. در حالت آزمایشی همهٔ اعتبارسنجی‌ها (کلید، محصول، نام، موبایل، کد ملی) انجام می‌شود ولی هزینه‌ای کسر نمی‌شود و سندی تولید نمی‌شود.

درخواست

—

پاسخ

—

کلید شما فقط در همین صفحه و در حافظهٔ مرورگر شما استفاده می‌شود و جایی ذخیره نمی‌شود.

🧩 SDK — کتابخانهٔ اتصال

کلاینت تک‌فایلی برای زبان دلخواه‌تان — کپی یا دانلود کنید، bd_live_XXXX را با کلید خودتان و PRODUCT_ID را با شناسهٔ محصول (تب «محصولات») جایگزین کنید. هر سه SDK از حالت آزمایشی (test)، Idempotency-Key و انتظار برای آماده‌شدن سند پشتیبانی می‌کنند.

💰 تعرفه‌ها

پرداخت به ازای هر درخواست — بدون اشتراک ماهانه. مبالغ به تومان:

درخواست‌های ناموفق (خطای سرور) به‌صورت خودکار برگشت داده می‌شوند. لینک دانلود تا ۷۲ ساعت معتبر است.

🚀 شروع سریع

• ۱ — با حساب فروشنده وارد شوید و از تب کنسول یک کلید API بسازید.
• ۲ — شناسه محصول خود را از GET /api/v1/products بگیرید.
• ۳ — برای هر مشتری یک درخواست stamp بفرستید و لینک دانلود را تحویل بگیرید.
• 💡 قبل از اتصال واقعی، با "test": true (یا تب تست آنلاین) درخواست‌تان را رایگان اعتبارسنجی کنید.

curl -X POST "https://buydocs.ir/api/v1/products/PRODUCT_ID/stamp" \
  -H "Authorization: Bearer bd_live_XXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: my-order-1001" \
  -d '{
    "first_name": "علی",
    "last_name": "رضایی",
    "phone_number": "09123456789",
    "national_code": "0012345678"
  }'

پاسخ (201):

{
  "document_id": "d3f1c2...",
  "status": "processing",
  "download_url": "https://buydocs.ir/api/v1/documents/d3f1c2.../download?exp=...&sig=...",
  "expires_epoch": 1780000000,
  "charged": 45000
}

لینک download_url را به مشتری بدهید؛ تا آماده‌شدن سند، پاسخ 202 با هدر Retry-After برمی‌گردد و سپس فایل PDF دانلود می‌شود. برای دانلود نیازی به کلید API نیست — لینک امضاشده و زمان‌دار است.

📚 مرجع Endpoint ها

احراز هویت: هدر Authorization: Bearer bd_live_...

بدنهٔ درخواست stamp

هدرها

• Idempotency-Key (پیشنهادی): شناسهٔ سفارش خودتان. تکرار همان درخواست (مثلاً بعد از قطعی شبکه) سند قبلی را برمی‌گرداند و هزینهٔ دوباره کسر نمی‌شود.

کدهای خطا

❓ نکات مهم

• سندها با همان موتور واترمارک بایداکس تولید می‌شوند: نام، موبایل و در صورت ارسال، کد ملی مشتری روی صفحات درج و اثر انگشت دیجیتال ثبت می‌شود.
• فایل تولیدشده و لینک آن پس از انقضا حذف می‌شوند — لینک را به‌موقع تحویل مشتری دهید.
• اگر تولید سند به هر دلیلی شکست بخورد، مبلغ به‌صورت خودکار به کیف پول برمی‌گردد (فیلد refunded).
• برای پشتیبانی فنی از صفحهٔ تماس با ما پیام بدهید.