{"openapi":"3.1.0","info":{"title":"优剪运营数据 API","version":"1.0.0","description":"开业日期 openedOn 仅接受已核实的官方开业日期；当前接口未提供时为 null。firstSeenAt 是首次发现，不代表开业。目录每日检查，暂时未返回不等于关店。\n确认单是 qid 首次被观察到 queuedStatus=2 服务中，按 qid 去重并保留首次服务归属；不代表支付完成或全天完整成交量。\n日、小时按首次服务观察时间的 Asia/Shanghai 时区统计；confirmed 与 observed 两类统计时间不可混用。\n实际下单、服务开始、支付时间、消费金额、客单价和完整历史尚未取得；逐人轮询可能漏计。\n无观察的时段没有统计行，不认定为真实零单。空值、失败、休息或 qid 消失不代表零单或服务完成。\n在岗及门店排队快照超过 7 分钟转未知；逐条服务详情超过 2 分钟当前未知。排队人数不是确认订单数。\n目录取得 2167 家，官方城市计数 2168 家，差 1 家原因未明；人员为取得目录范围内去重名册，可能继续增长。"},"servers":[{"url":"https://uream.yingbei365.com/api/v1"}],"security":[{"ApiKey":[]}],"tags":[{"name":"directory:read","description":"门店与地区目录"},{"name":"staff:read","description":"理发师与在岗状态"},{"name":"queues:read","description":"取号、状态事件与门店排队"},{"name":"orders:read","description":"已观察确认服务单"},{"name":"analytics:read","description":"每日、小时统计与门店排行"},{"name":"operations:read","description":"采集覆盖、中断与日志"}],"paths":{"/cities":{"get":{"operationId":"cities","summary":"地区与城市目录","description":"需要 directory:read。","tags":["directory:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"q","in":"query","required":false,"description":"名称搜索，排行搜索保留原地区排名和占比","schema":{"type":"string"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"name":{"type":"string","description":"name"},"province":{"type":["string","null"],"description":"province"},"region":{"type":["string","null"],"description":"region"},"officialStoreCount":{"type":["number","null"],"description":"officialStoreCount"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/stores":{"get":{"operationId":"stores","summary":"门店目录","description":"需要 directory:read。","tags":["directory:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"q","in":"query","required":false,"description":"名称搜索，排行搜索保留原地区排名和占比","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"name":{"type":"string","description":"name"},"city":{"type":"string","description":"city"},"province":{"type":["string","null"],"description":"province"},"region":{"type":["string","null"],"description":"region"},"address":{"type":"string","description":"address"},"phone":{"type":["string","null"],"description":"phone"},"hours":{"type":["string","null"],"description":"hours"},"haircutPrice":{"type":["number","null"],"description":"haircutPrice"},"coloringPrice":{"type":["number","null"],"description":"coloringPrice"},"readAt":{"type":"string","description":"readAt"},"openedOn":{"type":["string","null"],"format":"date","description":"真实开业日期，当前官方接口未提供时 null；不能用首次发现时间替代。"},"openingSource":{"type":["string","null"],"description":"openingSource"},"firstSeenAt":{"type":["string","null"],"description":"目录首次观察时间；初始已有门店保留最早取得时间，不算新增。"},"lastSeenAt":{"type":["string","null"],"description":"lastSeenAt"},"lastCheckedAt":{"type":["string","null"],"description":"lastCheckedAt"},"openStatus":{"type":["number","null"],"description":"官方开业状态原始代码，不是开业日期。"},"district":{"type":["string","null"],"description":"district"},"catalogState":{"type":["string","null"],"description":"present 本次返回 / missing 本次未返回 / baseline 初始尚未核对；missing 不代表已关店。"},"isBaseline":{"type":["boolean","null"],"description":"isBaseline"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/store-directory-events":{"get":{"operationId":"store_directory_events","summary":"门店新增与目录变化","description":"需要 directory:read。","tags":["directory:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"eventKey":{"type":"string","description":"eventKey"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"eventType":{"type":"string","description":"eventType"},"observedAt":{"type":"string","description":"observedAt"},"beforeValue":{"type":["string","null"],"description":"beforeValue"},"afterValue":{"type":["string","null"],"description":"afterValue"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/store-directory-runs":{"get":{"operationId":"store_directory_runs","summary":"每日门店目录监控","description":"需要 operations:read。","tags":["operations:read"],"parameters":[{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"finishedAt":{"type":["string","null"],"description":"finishedAt"},"status":{"type":"string","description":"status"},"expectedCities":{"type":["number","null"],"description":"expectedCities"},"succeededCities":{"type":["number","null"],"description":"succeededCities"},"officialStores":{"type":["number","null"],"description":"officialStores"},"returnedStores":{"type":["number","null"],"description":"returnedStores"},"newStores":{"type":["number","null"],"description":"newStores"},"missingStores":{"type":["number","null"],"description":"missingStores"},"errorCode":{"type":["string","null"],"description":"errorCode"},"nextCheckAt":{"type":"string","description":"目录低频监控下次检查时间，每 24 小时一次。"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/hairdressers":{"get":{"operationId":"hairdressers","summary":"去重理发师名册","description":"需要 staff:read。","tags":["staff:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"q","in":"query","required":false,"description":"名称搜索，排行搜索保留原地区排名和占比","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"name":{"type":"string","description":"name"},"readAt":{"type":"string","description":"readAt"},"storeIds":{"type":"array","items":{"type":"string"},"description":"字符串门店 ID 列表；可能有跨店归属"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/hairdresser-stores":{"get":{"operationId":"hairdresser_stores","summary":"理发师与门店归属","description":"需要 staff:read。","tags":["staff:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"personId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"readAt":{"type":"string","description":"readAt"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/staff-states":{"get":{"operationId":"staff_states","summary":"最近在岗快照","description":"需要 staff:read。","tags":["staff:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"personId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"activeStatus":{"type":["number","null"],"description":"activeStatus"},"waitingCount":{"type":["number","null"],"description":"waitingCount"},"status":{"type":"string","description":"status"},"workState":{"type":"string","description":"workState"},"observedAt":{"type":"string","description":"observedAt"},"fresh":{"type":["boolean","null"],"description":"快照是否在 7 分钟有效期内；false 时当前状态未知"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/queue-records":{"get":{"operationId":"queue_records","summary":"逐条取号与最后观察状态","description":"需要 queues:read。","tags":["queues:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"status","in":"query","required":false,"description":"0 排队、1 叫号、2 服务中","schema":{"type":"string","enum":["0","1","2"]}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"qid":{"type":"string","description":"字符串取号 ID；与支付订单的一对一关系尚未验证"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"craftsmanId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"queuedStatus":{"type":["number","null"],"description":"最后观察状态：0 排队中、1 叫号中、2 服务中、null 未提供"},"sourceTimeText":{"type":["string","null"],"description":"小程序时间文案，不是下单时间"},"firstObservedAt":{"type":"string","description":"firstObservedAt"},"lastObservedAt":{"type":"string","description":"lastObservedAt"},"firstServiceObservedAt":{"type":["string","null"],"description":"firstServiceObservedAt"},"isBooking":{"type":["boolean","null"],"description":"isBooking"},"assignmentChanged":{"type":["boolean","null"],"description":"assignmentChanged"},"currentStatusKnown":{"type":["boolean","null"],"description":"最后观察是否在最近 2 分钟内；false 时当前状态未知"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/queue-events":{"get":{"operationId":"queue_events","summary":"取号状态变化事件","description":"需要 queues:read。","tags":["queues:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"status","in":"query","required":false,"description":"0 排队、1 叫号、2 服务中","schema":{"type":"string","enum":["0","1","2"]}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"eventKey":{"type":"string","description":"eventKey"},"qid":{"type":"string","description":"字符串取号 ID；与支付订单的一对一关系尚未验证"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"craftsmanId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"queuedStatus":{"type":["number","null"],"description":"最后观察状态：0 排队中、1 叫号中、2 服务中、null 未提供"},"observedAt":{"type":"string","description":"observedAt"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/store-queues":{"get":{"operationId":"store_queues","summary":"门店排队快照","description":"需要 queues:read。","tags":["queues:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"queuedCount":{"type":["number","null"],"description":"接口排队人数；null 未取得，不是订单量"},"waitingText":{"type":"string","description":"waitingText"},"observedAt":{"type":"string","description":"observedAt"},"fresh":{"type":["boolean","null"],"description":"快照是否在 7 分钟有效期内；false 时当前状态未知"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/store-queue-history":{"get":{"operationId":"store_queue_history","summary":"门店排队历史","description":"需要 queues:read。","tags":["queues:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"queuedCount":{"type":["number","null"],"description":"接口排队人数；null 未取得，不是订单量"},"waitingText":{"type":"string","description":"waitingText"},"observedAt":{"type":"string","description":"observedAt"},"roundId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/confirmations":{"get":{"operationId":"confirmations","summary":"确认服务单明细","description":"需要 orders:read。","tags":["orders:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"updatedSince","in":"query","required":false,"description":"带时区 ISO 8601 增量边界，包含该时间，按主键去重","schema":{"type":"string","format":"date-time"}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"qid":{"type":"string","description":"字符串取号 ID；与支付订单的一对一关系尚未验证"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"craftsmanId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"confirmedObservedAt":{"type":"string","description":"首次读到 queuedStatus=2 的 UTC 时间，不是实际下单、服务开始或支付时间"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/confirmed-daily":{"get":{"operationId":"confirmed_daily","summary":"每人每日确认量","description":"需要 analytics:read。","tags":["analytics:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Asia/Shanghai 观察日期 YYYY-MM-DD"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"craftsmanId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"confirmedOrders":{"type":["number","null"],"description":"已观察到服务中的 qid 去重数，不是完整付款成交量"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/confirmed-hourly":{"get":{"operationId":"confirmed_hourly","summary":"每人每小时确认量","description":"需要 analytics:read。","tags":["analytics:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Asia/Shanghai 观察日期 YYYY-MM-DD"},"hour":{"type":"string","description":"Asia/Shanghai 观察小时 00–23"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"craftsmanId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"confirmedOrders":{"type":["number","null"],"description":"已观察到服务中的 qid 去重数，不是完整付款成交量"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/observed-daily":{"get":{"operationId":"observed_daily","summary":"按首次取号观察日统计","description":"需要 analytics:read。","tags":["analytics:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Asia/Shanghai 观察日期 YYYY-MM-DD"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"craftsmanId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"observedQueueRecords":{"type":["number","null"],"description":"observedQueueRecords"},"observedServiceRecords":{"type":["number","null"],"description":"按首次取号观察时间汇总的曾服务记录数，不可替代 confirmed 统计"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/observed-hourly":{"get":{"operationId":"observed_hourly","summary":"按首次取号观察小时统计","description":"需要 analytics:read。","tags":["analytics:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Asia/Shanghai 观察日期 YYYY-MM-DD"},"hour":{"type":"string","description":"Asia/Shanghai 观察小时 00–23"},"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"craftsmanId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"observedQueueRecords":{"type":["number","null"],"description":"observedQueueRecords"},"observedServiceRecords":{"type":["number","null"],"description":"按首次取号观察时间汇总的曾服务记录数，不可替代 confirmed 统计"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/store-rankings":{"get":{"operationId":"store_rankings","summary":"整店确认观察量排行","description":"需要 analytics:read。","tags":["analytics:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"from","in":"query","required":false,"description":"北京时间开始日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"北京时间结束日期，包含当天","schema":{"type":"string","format":"date"}},{"name":"q","in":"query","required":false,"description":"名称搜索，排行搜索保留原地区排名和占比","schema":{"type":"string"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"name":{"type":"string","description":"name"},"city":{"type":"string","description":"city"},"confirmedOrders":{"type":["number","null"],"description":"已观察到服务中的 qid 去重数，不是完整付款成交量"},"observedHairdressers":{"type":["number","null"],"description":"observedHairdressers"},"lastConfirmedObservedAt":{"type":["string","null"],"description":"lastConfirmedObservedAt"},"rank":{"type":["number","null"],"description":"同确认观察量并列排名，无确认观察为 null"},"share":{"type":["number","null"],"description":"所选地区确认观察量占比，无确认观察为 null"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/live-summary":{"get":{"operationId":"live_summary","summary":"当前人员活动与覆盖汇总","description":"需要 staff:read 和 queues:read。","tags":["staff:read"],"parameters":[{"name":"region","in":"query","required":false,"description":"大区，例如华南、西南","schema":{"type":"string"}},{"name":"province","in":"query","required":false,"description":"省份，例如广东、云南","schema":{"type":"string"}},{"name":"city","in":"query","required":false,"description":"城市，例如深圳、昆明","schema":{"type":"string"}},{"name":"storeId","in":"query","required":false,"description":"字符串门店 ID，受密钥范围限制","schema":{"type":"string"}},{"name":"personId","in":"query","required":false,"description":"字符串理发师 ID","schema":{"type":"string"}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"roster":{"type":["number","null"],"description":"roster"},"working":{"type":["number","null"],"description":"working"},"off":{"type":["number","null"],"description":"off"},"unknown":{"type":["number","null"],"description":"unknown"},"servingObserved":{"type":["number","null"],"description":"servingObserved"},"available":{"type":["number","null"],"description":"available"},"eating":{"type":["number","null"],"description":"eating"},"resting":{"type":["number","null"],"description":"resting"},"paused":{"type":["number","null"],"description":"paused"},"awaiting":{"type":["number","null"],"description":"awaiting"},"activityUnknown":{"type":["number","null"],"description":"activityUnknown"},"queueCoveredStores":{"type":["number","null"],"description":"queueCoveredStores"},"queuedCount":{"type":["number","null"],"description":"接口排队人数；null 未取得，不是订单量"},"detailCoveredStores":{"type":["number","null"],"description":"detailCoveredStores"},"detailCoveredPeople":{"type":["number","null"],"description":"detailCoveredPeople"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/coverage":{"get":{"operationId":"coverage","summary":"采集窗口与覆盖","description":"需要 operations:read。","tags":["operations:read"],"parameters":[{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"diagnostics":{"type":["object","null"],"description":"diagnostics"},"progress":{"type":["object","null"],"description":"progress"},"counts":{"type":["object","null"],"description":"counts"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/roster-coverage":{"get":{"operationId":"roster_coverage","summary":"逐店名册覆盖","description":"需要 operations:read。","tags":["operations:read"],"parameters":[{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"readAt":{"type":"string","description":"readAt"},"peopleCount":{"type":["number","null"],"description":"peopleCount"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/monitor-runs":{"get":{"operationId":"monitor_runs","summary":"采集运行记录","description":"需要 operations:read。","tags":["operations:read"],"parameters":[{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"runId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"phase":{"type":"string","description":"phase"},"deadlineAt":{"type":["string","null"],"description":"deadlineAt"},"endedAt":{"type":["string","null"],"description":"endedAt"},"elapsedSeconds":{"type":["number","null"],"description":"elapsedSeconds"},"successfulResponses":{"type":["number","null"],"description":"successfulResponses"},"failedResponses":{"type":["number","null"],"description":"failedResponses"},"unavailableResponses":{"type":["number","null"],"description":"unavailableResponses"},"hairdressersObserved":{"type":["number","null"],"description":"hairdressersObserved"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/directory-differences":{"get":{"operationId":"directory_differences","summary":"目录差异","description":"需要 operations:read。","tags":["operations:read"],"parameters":[{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"city":{"type":"string","description":"city"},"expected":{"type":["number","null"],"description":"expected"},"actualNonTest":{"type":["number","null"],"description":"actualNonTest"},"rawReturned":{"type":["number","null"],"description":"rawReturned"},"testRecords":{"type":["number","null"],"description":"testRecords"},"checkedAt":{"type":"string","description":"checkedAt"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/interruptions":{"get":{"operationId":"interruptions","summary":"采集中断记录","description":"需要 operations:read。","tags":["operations:read"],"parameters":[{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"lastObservedBefore":{"type":"string","description":"lastObservedBefore"},"restartObservedAt":{"type":"string","description":"restartObservedAt"},"resumedAt":{"type":"string","description":"resumedAt"},"reason":{"type":"string","description":"reason"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/excluded-stores":{"get":{"operationId":"excluded_stores","summary":"已排除的测试门店","description":"需要 operations:read。","tags":["operations:read"],"parameters":[{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"storeId":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"city":{"type":"string","description":"city"},"testStatus":{"type":["number","null"],"description":"testStatus"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/logs":{"get":{"operationId":"logs","summary":"非敏感采集日志","description":"需要 operations:read。","tags":["operations:read"],"parameters":[{"name":"page","in":"query","required":false,"description":"页码从 1 开始","schema":{"type":"integer","minimum":1,"maximum":10000,"default":1}},{"name":"limit","in":"query","required":false,"description":"每页 1–500 条，默认 100","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}}],"responses":{"200":{"description":"已保存的业务观察记录；空数组不代表真实零单","content":{"application/json":{"schema":{"type":"object","required":["data","pagination","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"字符串 ID，不可转为浮点 Number"},"observedAt":{"type":"string","description":"observedAt"},"message":{"type":"string","description":"message"}}}},"pagination":{"$ref":"#/components/schemas/Pagination"},"meta":{"$ref":"#/components/schemas/Meta"}}}}}},"400":{"description":"参数无效","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"密钥无效、撤销或过期","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"权限或门店范围不足","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"接口不存在","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"调用过快，Retry-After: 60","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"暂时不可用","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"udr_live_...","description":"在线上私有后台 /api-settings 创建，完整密钥仅显示一次"}},"schemas":{"Pagination":{"type":"object","properties":{"page":{"type":"integer"},"limit":{"type":"integer"},"total":{"type":"integer"},"hasMore":{"type":"boolean"},"nextPage":{"type":["integer","null"]}}},"Meta":{"type":"object","properties":{"requestId":{"type":"string","format":"uuid"},"generatedAt":{"type":"string","format":"date-time"},"snapshotAt":{"type":["string","null"]},"diagnosticsAt":{"type":["string","null"]},"timezone":{"type":"string","const":"Asia/Shanghai"},"resource":{"type":"string"},"scope":{"type":"object"},"statisticsBasis":{"type":"string"},"limitations":{"type":"array","items":{"type":"string"}}}},"Error":{"type":"object","properties":{"requestId":{"type":"string"},"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"}}}}}}}}