اتصال تجاری فروشگاهها به اکوسیستم توران، سریع و بدون پیچیدگی
پلتفرم وبسرویس توران ابزار لازم برای مدیریت موجودی، سفارش و تسویه را در قالب APIهای پایدار و مستند در اختیار شما قرار میدهد. با زیرساخت ابری و پشتیبانی فارسی، توسعهدهندگان میتوانند در کوتاهترین زمان فروشگاه خود را به سامانه مرکزی توران متصل کنند.
99.9%
آپتایم تضمینی
50ms
میانگین پاسخ
+120
فروشگاه فعال
جریان زنده سفارشات
Real-Time{
"id": "TRN-458210",
"status": "accepted",
"total": 3070000,
"items": [
{ "sku": "TRN-001", "qty": 2 },
{ "sku": "TRN-144", "qty": 1 }
],
"route": "express",
"timestamp": "2024-04-18T09:24:41Z"
}
نظارت هوشمند
مانیتورینگ لحظهای SLA و هشدار خودکار اختلالات.
تحلیل تراکنش
دسترسی به داشبورد تحلیلی و شاخصهای کلیدی رشد.
Platform Capabilities
زیرساخت آماده برای رشد سریع و پایدار
سامانه توران نیازهای فروشگاههای در حال توسعه و شرکتهای سازمانی را پوشش میدهد. انعطافپذیری APIها، امنیت چندلایه و پشتیبانی اختصاصی، مسیر مهاجرت و راهاندازی را کوتاه و کارآمد میکند.
اتصال لحظهای موجودی
ناهماهنگی موجودی را حذف کنید؛ هر تغییر همزمان در سامانه توران و فروشگاه شما ثبت میشود.
داشبورد مالی هوشمند
تسویهها، واریزها و بدهیها را شفاف ببینید و گزارش مالیات بر ارزشافزوده را تهیه کنید.
امنیت سطح سازمانی
احراز هویت چندلایه، ثبت وقایع امنیتی و امکان تعریف سطح دسترسی برای اعضای تیم.
SDK و مستندات فارسی
نمونهکدهای کاربردی و SDKهای رسمی برای PHP، Node.js و .NET همراه با ویدیوهای آموزشی.
Integration Roadmap
مسیر اتصال به توران در چهار گام
برای شروع همکاری، کافی است گامهای زیر را دنبال کنید. تیم فنی توران در هر مرحله همراه شما است و تأییدیهها را به صورت لحظهای اطلاع میدهد.
دریافت دسترسی و توکن
اطلاعات کسبوکار را در پنل فروشندگان ثبت کنید. پس از تأیید، کلیدهای Client ID/Secret و توکن سندباکس صادر میشود.
ورود به پنلپیکربندی محیط توسعه
از SDKهای رسمی یا درخواستهای REST استفاده کنید. آدرس پایه محیط آزمایشی: https://sandbox.api.turan.ir
اجرای سناریوهای تست
سناریوهای ثبت سفارش، بروزرسانی موجودی، تسویه و وبهوکها را در سندباکس اجرا و گزارش لاگها را برای تیم ما ارسال کنید.
سوئیچ به محیط عملیاتی
پس از تأیید تستها، کلیدهای عملیاتی صادر میشود و از طریق آدرس زیر میتوانید فعالیت پایدار خود را آغاز کنید: https://api.turan.ir
مستندات و نمونهکدها
راهنمای کامل احراز هویت، ساختار پاسخها، مدیریت خطا و نمونهکد پشتخط برای سه زبان اصلی در این مستند قرار گرفته است.
API Catalog
معماری API و سرویسهای در دسترس
درخواستها بر بستر HTTPS و با احراز هویت Bearer ارسال میشوند. نرخ پیشفرض ۵۰۰ درخواست در دقیقه است و امکان افزایش سقف با هماهنگی تیم پشتیبانی وجود دارد.
API های عمومی
-
GET /api/v1/catalog/products
لیست محصولات با قیمت، موجودی و مشخصات به همراه فیلترهای متعدد.
-
GET /api/v1/catalog/categories
ساختار درختی دستهبندیها جهت همگامسازی فروشگاه شما.
-
GET /api/v1/support/status
وضعیت لحظهای سرویس، زمانبندی نگهداری و هشدارهای فنی.
API های فروشندگان
-
POST /api/v1/orders
ثبت سفارش جدید و دریافت کد پیگیری یکتا با جزئیات ارسال.
-
PATCH /api/v1/inventory/{sku}
بهروزرسانی موجودی، قیمت و وضعیت عرضه محصول.
-
GET /api/v1/settlements
گزارش تسویهها، تراکنشها و امکان دریافت فایل مالیاتی.
نمونه فراخوانی با Fetch (Node.js)
در نمونه زیر، سفارش جدید ثبت و پاسخ وضعیت سفارش دریافت میشود. توکن را از متغیر محیطی امن بخوانید.
import fetch from 'node-fetch';
const endpoint = 'https://api.turan.ir/api/v1/orders';
const token = process.env.TURAN_TOKEN;
async function createOrder() {
const response = await fetch(endpoint, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Authorization': `Bearer ${token}`
},
body: JSON.stringify({
reference: 'SHOP-654321',
items: [
{ sku: 'TRN-001', quantity: 2, price: 890000 },
{ sku: 'TRN-144', quantity: 1, price: 1290000 }
],
customer: {
name: 'شرکت راهکار نوین',
phone: '02112345678',
address: 'تهران، خیابان آزادی، پلاک ۱۲۳'
},
delivery_type: 'express'
})
});
if (!response.ok) {
throw new Error(`خطای ${response.status}: ${await response.text()}`);
}
return response.json();
}
createOrder()
.then(result => console.log('Order created:', result))
.catch(error => console.error('Failed:', error));
پیشنیازهای فنی
- احراز هویت: OAuth2 Client Credentials با زمان انقضای ۶۰ دقیقه و امکان تمدید خودکار.
- نرخ درخواست: ۵۰۰ درخواست در دقیقه؛ برای سقف بالاتر از پشتیبانی درخواست ارتقا بدهید.
- وبهوکهای امنیتی: امضای دیجیتال درخواستها و پیکربندی IPهای مجاز جهت جلوگیری از حملات.
- تست و استقرار: تمامی سناریوها قبل از ورود به محیط عملیاتی باید در سندباکس تأیید شوند.
Growth Partner
به شبکه توزیع توران بپیوندید
با اتصال فروشگاه خود، به شبکه لجستیک و مالی یکپارچه توران دسترسی پیدا میکنید. دادههای فروش خود را تحلیل کرده و با کمپینهای مشترک فروش، رشد بازار را تجربه کنید.
Support
پشتیبانی ۲۴ ساعته و کانالهای اختصاصی
تیم فنی توران آماده پاسخگویی به سوالات و بررسی درخواستهای شما است. کانالهای ارتباطی زیر برای دسترسی سریعتر طراحی شدهاند.
تیکت داخل پنل
از منوی «پشتیبانی» در پنل فروشندگان درخواست خود را ثبت کنید تا کمتر از ۳۰ دقیقه پاسخ دریافت کنید.
ورود به پنلکانال تلگرام
آخرین اطلاعیههای فنی، تغییرات API و زمانبندی نگهداری را دنبال کنید.
t.me/turan-support