权限范围(Scopes)
delivery_zones:read— 列出区域、获取单个区域以及检查覆盖范围。delivery_zones:write— 创建、更新和删除区域。
创建区域
区域名称在每个门店内必须唯一。polygon 是由 [longitude, latitude] 环组成的 GeoJSON Polygon — 第一个环必须闭合(首尾点相同)。
delivery_fee_cents 默认为 0,is_active 默认为 true,priority 默认为 0,zone_type 默认为 polygon。响应是创建出的 delivery_zone 对象;请使用其 id 调用区域端点。
覆盖范围检查始终以 polygon 为准。zone_type: 'circle' 和 radius_miles 仅是描述性元数据 — 对于圆形区域,请提交一个近似该圆的多边形。
列出区域
{ "object": "list", "data": [...] },其中仅包含启用的区域。
更新区域
PATCH 只更改您发送的字段:
删除区域
删除操作会停用该区域(它将从列表结果和覆盖范围检查中消失):检查某个坐标是否可配送
在报价配送之前,请对照门店的区域检查顾客的坐标:delivery_zone_check:in_zone 表示该门店是否配送到该处;为 true 时,zone 携带匹配的区域,delivery_fee_cents 为其费用。为 false 时,两者均为 null。
对于属于其他门店的区域,区域的 get/update/delete 会返回 404 — 合作伙伴只能操作路径中所指门店所拥有的区域。