منو

Developer Hub

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

همه چیز برای اتصال فروشگاه شما به وایدو: افزونه وردپرس، API RESTful با احراز هویت توکن، و مستندات کامل همه endpointها با نمونه کد در چهار زبان.

آدرس پایه (Base URL):
http://whydo.ir/api/v1

افزونه Wido Sync (ووکامرس)

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

دانلود افزونه (ZIP)

روند کامل افزونه ووکامرس

افزونه چه کارهایی به ترتیب انجام می‌دهد:

  1. ادمین نام کاربری/رمز وایدو + دسته‌بندی‌های پیش‌فرض را در Wido Sync ذخیره می‌کند.
  2. روی لیست محصولات ووکامرس می‌زند → لیست محصولات WC لود می‌شود.
  3. تیک محصولات را می‌زند و ارسال به وایدو را می‌زند.
  4. افزونه برای هر محصول: POST /auth/login/ → توکن → POST /products/ با payload کامل (title, price, stock, description, category_id, is_active).
  5. سپس POST /products/{new_id}/image-from-url/ با URL تصویر شاخص ووکامرس.
  6. اگر محصول قبلاً ساخته شده باشد، تغییرات بعدی در ووکامرس خودکار PATCH /products/{id}/ می‌شوند.
مستندات کامل OpenAPI: /api/v1/docs

۱. احراز هویت

اول با شماره موبایل و رمز، توکن بگیرید. سپس توکن را در هدر Authorization: Bearer <TOKEN> بفرستید.

POST /auth/login/ دریافت توکن

توضیح: با این endpoint وارد می‌شوید. اگر قبلاً توکن داشته باشید، همان برگردانده می‌شود.

Request body:

{
  "phone_number": "09123456789",
  "password": "your_password"
}

Response 200:

{
  "token": "8cddfdc05153db78...",
  "user": {
    "id": 42,
    "phone_number": "09123456789",
    "is_vendor": true
  }
}
مستندات کامل OpenAPI: /api/v1/docs