شروع در ۵ دقیقه

آنچه یاد می‌گیرید: ساخت کلید آزمایشی، فرستادن اولین درخواست و خواندن فهرست تنوع‌های پنل.

1. کلید آزمایشی بسازید. در پنل نمایشی سلر ۳۶۰، به «تنظیمات پنل ← API و وب‌هوک» بروید و «ساخت کلید» را بزنید. کلید فقط یک بار نمایش داده می‌شود و با s360_test_ شروع می‌شود.

2. کلید را در متغیر محیطی بگذارید، نه در کد:

   export S360_API_KEY="s360_test_..."

3. اولین درخواست را بفرستید:

   curl

   curl https://api.seller360.ir/v1/me \
     -H "Authorization: Bearer $S360_API_KEY"

   PHP

   $ch = curl_init("https://api.seller360.ir/v1/me");
   curl_setopt_array($ch, [
       CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("S360_API_KEY")],
       CURLOPT_RETURNTRANSFER => true,
   ]);
   $me = json_decode(curl_exec($ch), true);
   echo $me["data"]["panel"]["name"];

   Python

   import os, requests
   
   me = requests.get(
       "https://api.seller360.ir/v1/me",
       headers={"Authorization": f"Bearer {os.environ['S360_API_KEY']}"},
       timeout=15,
   ).json()
   print(me["data"]["panel"]["name"])

   Node.js

   const res = await fetch('https://api.seller360.ir/v1/me', {
     headers: { Authorization: `Bearer ${process.env.S360_API_KEY}` },
   })
   const me = await res.json()
   console.log(me.data.panel.name)

4. پاسخ را ببینید:

   {
     "status": "ok",
     "data": {
       "panel": { "id": 7, "name": "فروشگاه نمونه" },
       "key": { "name": "سایت فروشگاه", "prefix": "s360_test_aB3d", "environment": "test",
                "scopes": ["catalog:read", "stock:read"], "created_at": "2026-11-12T09:30:00+03:30" },
       "limits": { "read_per_minute": 120, "write_per_minute": 30 }
     }
   }

کلید را محرمانه نگه دارید

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

قدم بعد

• مدل موجودی: سایت شما باید کدام عدد را نشان دهد.
• مرجع مسیرها: همه‌ی مسیرها با جزئیات.