شروع سریع
در چند دقیقه آماده استفاده از 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