GET

/admin/api/2026-07/zones.json

מחזיר את כל האזורים בחנות, עם אפשרות סינון לפי סטטוס פרסום.

נסו את זה

פרמטרים

statusstring, לא חובהסינון לפי סטטוס האזור. אחד מהערכים draft, published, archived. השמיטו כדי להחזיר את כל הסטטוסים.

limitinteger, לא חובהמספר האזורים להחזרה בכל עמוד. ברירת מחדל 50, מקסימום 250.

page_infostring, לא חובהמזהה עמוד מתוך כותרת התגובה Link, המשמש לשליפת העמוד הבא או הקודם.

תגובות שגיאה

401UNAUTHORIZEDלבקשה חסרה כותרת X-Shopify-Access-Token תקפה.

403MISSING_SCOPEלאסימון הגישה אין את ההרשאה read_shipping.

429RATE_LIMITEDמגבלת קריאות ה-Admin API של החנות הגיעה למקסימום. נסו שוב לאחר הזמן שצוין בכותרת Retry-After.

גוף הבקשה

{
  "zones": [
    {
      "id": 918273645,
      "name": "Downtown same-day",
      "status": "published",
      "coverage_type": "radius",
      "created_at": "2026-04-02T09:14:00-04:00"
    }
  ]
}

תגובה 201

{
  "zones": [
    {
      "id": 918273645,
      "name": "Downtown same-day",
      "status": "published",
      "coverage_type": "radius",
      "created_at": "2026-04-02T09:14:00-04:00"
    }
  ]
}

curl "https://{shop}.myshopify.com/admin/api/2026-07/zones.json?status=published" \
  -H "X-Shopify-Access-Token: {access_token}"

session = ShopifyAPI::Auth::Session.new(shop: shop, access_token: token)
client = ShopifyAPI::Clients::Rest::Admin.new(session: session)
response = client.get(path: "zones", query: { status: "published" })
puts response.body["zones"]

const response = await fetch(
  `https://${shop}/admin/api/2026-07/zones.json?status=published`,
  { headers: { 'X-Shopify-Access-Token': accessToken } },
);
const { zones } = await response.json();