شروع سریع

در چند دقیقه آماده استفاده از API بشوید

01

ثبت‌نام و احراز هویت

با شماره موبایل ثبت‌نام کنید و از طریق کد OTP هویت خود را تأیید کنید.

bash
# ارسال کد OTP
curl -X POST http://localhost:8000/v1/auth/otp/send \
  -H "Content-Type: application/json" \
  -d '{"phone": "09123456789"}'

# تأیید OTP و دریافت توکن
curl -X POST http://localhost:8000/v1/auth/otp/verify \
  -H "Content-Type: application/json" \
  -d '{"phone": "09123456789", "code": "123456"}'
02

دریافت کلید API

پس از ورود، از داشبورد مدیریت یک کلید API جدید بسازید. کلیدها توسط ادمین تأیید می‌شوند.

bash
curl -X POST http://localhost:8000/v1/keys \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "production-key", "expires_in": 365}'

# Response
{
  "id": "key_01jxxxxxxxx",
  "key": "fc_live_xxxxxxxxxxxxxxxxxxxxxxxx",
  "expires_at": "2027-05-31T00:00:00Z"
}
03

اولین درخواست API

کلید API را در هدر X-Api-Key قرار دهید و اولین درخواست را ارسال کنید.

bash
curl -X GET http://localhost:8000/v1/products \
  -H "X-Api-Key: fc_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json"

# Response
{
  "data": [
    { "id": "prod_01", "name": "محصول نمونه", "price": 5000000 }
  ],
  "total": 1
}

آماده‌اید؟

برای مشاهده تمام endpoint‌ها و مستندات تعاملی کامل به پورتال API مراجعه کنید.

مشاهده مستندات API