T

Turan API Platform

سامانه یکپارچه وب‌سرویس توران

وضعیت سرویس: پایدار و آماده اتصال SLA تضمینی ۹۹.۹٪

اتصال تجاری فروشگاه‌ها به اکوسیستم توران، سریع و بدون پیچیدگی

پلتفرم وب‌سرویس توران ابزار لازم برای مدیریت موجودی، سفارش و تسویه را در قالب APIهای پایدار و مستند در اختیار شما قرار می‌دهد. با زیرساخت ابری و پشتیبانی فارسی، توسعه‌دهندگان می‌توانند در کوتاه‌ترین زمان فروشگاه خود را به سامانه مرکزی توران متصل کنند.

99.9%

آپ‌تایم تضمینی

50ms

میانگین پاسخ

+120

فروشگاه فعال

مورد اعتماد
TuranPOS Hyper Mall Jahan Market FintechX

جریان زنده سفارشات

Real-Time
Webhook: order.created 54ms
webhook.json
{
  "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ها، امنیت چندلایه و پشتیبانی اختصاصی، مسیر مهاجرت و راه‌اندازی را کوتاه و کارآمد می‌کند.

Sync

اتصال لحظه‌ای موجودی

ناهماهنگی موجودی را حذف کنید؛ هر تغییر همزمان در سامانه توران و فروشگاه شما ثبت می‌شود.

Finance

داشبورد مالی هوشمند

تسویه‌ها، واریزها و بدهی‌ها را شفاف ببینید و گزارش مالیات بر ارزش‌افزوده را تهیه کنید.

Security

امنیت سطح سازمانی

احراز هویت چندلایه، ثبت وقایع امنیتی و امکان تعریف سطح دسترسی برای اعضای تیم.

Develop

SDK و مستندات فارسی

نمونه‌کدهای کاربردی و SDKهای رسمی برای PHP، Node.js و .NET همراه با ویدیوهای آموزشی.

Integration Roadmap

مسیر اتصال به توران در چهار گام

برای شروع همکاری، کافی است گام‌های زیر را دنبال کنید. تیم فنی توران در هر مرحله همراه شما است و تأییدیه‌ها را به صورت لحظه‌ای اطلاع می‌دهد.

مرحله ۱

دریافت دسترسی و توکن

اطلاعات کسب‌وکار را در پنل فروشندگان ثبت کنید. پس از تأیید، کلیدهای Client ID/Secret و توکن سندباکس صادر می‌شود.

ورود به پنل
مرحله ۲

پیکربندی محیط توسعه

از SDKهای رسمی یا درخواست‌های REST استفاده کنید. آدرس پایه محیط آزمایشی: https://sandbox.api.turan.ir

مرحله ۳

اجرای سناریوهای تست

سناریوهای ثبت سفارش، بروزرسانی موجودی، تسویه و وب‌هوک‌ها را در سندباکس اجرا و گزارش لاگ‌ها را برای تیم ما ارسال کنید.

مرحله ۴

سوئیچ به محیط عملیاتی

پس از تأیید تست‌ها، کلیدهای عملیاتی صادر می‌شود و از طریق آدرس زیر می‌توانید فعالیت پایدار خود را آغاز کنید: https://api.turan.ir

مستندات و نمونه‌کدها

راهنمای کامل احراز هویت، ساختار پاسخ‌ها، مدیریت خطا و نمونه‌کد پشت‌خط برای سه زبان اصلی در این مستند قرار گرفته است.

دانلود مستندات PDF

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)

در نمونه زیر، سفارش جدید ثبت و پاسخ وضعیت سفارش دریافت می‌شود. توکن را از متغیر محیطی امن بخوانید.

create-order.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

ایمیل فنی

برای درخواست‌های سازمانی و مباحث فنی پیشرفته، ایمیل زیر پاسخ‌گوی شما است.

dev@turan.ir