{"openapi":"3.1.0","info":{"title":"蜂达速递 v0 开放接口","description":"蜂达速递核心业务系统 + 开放平台 API。内部接口前缀 /api，外部客户接入前缀 /open/v1。","version":"0.1.0"},"paths":{"/api/auth/login":{"post":{"tags":["内部-鉴权"],"summary":"登录获取 X-Token","operationId":"api_login_api_auth_login_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/me":{"get":{"tags":["内部-鉴权"],"summary":"当前登录用户","operationId":"api_me_api_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/config":{"get":{"tags":["内部-基础"],"summary":"获取字典常量","operationId":"api_config_api_config_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/orgs":{"get":{"tags":["内部-组织"],"summary":"组织列表（按权限过滤）","operationId":"api_orgs_api_orgs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["内部-组织"],"summary":"新增组织 / 加盟网点","operationId":"api_org_create_api_orgs_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/customers":{"get":{"tags":["内部-客户"],"summary":"客户列表","operationId":"api_customers_api_customers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["内部-客户"],"summary":"新增客户","operationId":"api_customer_create_api_customers_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/price-rules":{"get":{"tags":["内部-价格"],"summary":"报价规则列表","operationId":"api_price_rules_api_price_rules_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["内部-价格"],"summary":"新增报价规则","operationId":"api_price_rule_create_api_price_rules_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/lines":{"get":{"tags":["内部-运输"],"summary":"线路与班次","operationId":"api_lines_api_lines_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/waybills":{"post":{"tags":["内部-运单"],"summary":"创建运单（散件/合同/迁移）","operationId":"api_waybill_create_api_waybills_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"get":{"tags":["内部-运单"],"summary":"运单列表（分页 + 组织隔离）","operationId":"api_waybill_list_api_waybills_get","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","default":"","title":"Status"}},{"name":"keyword","in":"query","required":false,"schema":{"type":"string","default":"","title":"Keyword"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","default":1,"title":"Page"}},{"name":"size","in":"query","required":false,"schema":{"type":"integer","default":20,"title":"Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/waybills/{no}":{"get":{"tags":["内部-运单"],"summary":"运单详情","operationId":"api_waybill_detail_api_waybills__no__get","parameters":[{"name":"no","in":"path","required":true,"schema":{"type":"string","title":"No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/waybills/{no}/label":{"get":{"tags":["内部-运单"],"summary":"电子面单（可打印，含 Code39 条码）","operationId":"api_label_api_waybills__no__label_get","parameters":[{"name":"no","in":"path","required":true,"schema":{"type":"string","title":"No"}}],"responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/scans":{"post":{"tags":["内部-扫描"],"summary":"写入一条扫描事件（系统核心）","operationId":"api_scan_api_scans_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/waybills/{no}/events":{"get":{"tags":["内部-扫描"],"summary":"扫描事件流水","operationId":"api_events_api_waybills__no__events_get","parameters":[{"name":"no","in":"path","required":true,"schema":{"type":"string","title":"No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/track/{no}":{"get":{"tags":["公开-查件"],"summary":"客户查件轨迹（无需登录，手机号脱敏）","operationId":"api_track_api_track__no__get","parameters":[{"name":"no","in":"path","required":true,"schema":{"type":"string","title":"No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/fees":{"get":{"tags":["内部-结算"],"summary":"费用明细","operationId":"api_fees_api_fees_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"","title":"Period"}},{"name":"waybill_no","in":"query","required":false,"schema":{"type":"string","default":"","title":"Waybill No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/settlements/generate":{"post":{"tags":["内部-结算"],"summary":"按组织生成月度结算账单","operationId":"api_settle_generate_api_settlements_generate_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/settlements":{"get":{"tags":["内部-结算"],"summary":"结算账单列表","operationId":"api_settlements_api_settlements_get","parameters":[{"name":"period","in":"query","required":false,"schema":{"type":"string","default":"","title":"Period"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/dashboard":{"get":{"tags":["内部-看板"],"summary":"运营看板统计","operationId":"api_dashboard_api_dashboard_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/open-apps":{"get":{"tags":["内部-开放平台"],"summary":"开放平台应用列表","operationId":"api_open_apps_api_open_apps_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"post":{"tags":["内部-开放平台"],"summary":"创建接入应用（生成 app_key/secret）","operationId":"api_open_app_create_api_open_apps_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/open-apps/{aid}":{"patch":{"tags":["内部-开放平台"],"summary":"配置 Webhook / 关闭沙箱 / 停用","operationId":"api_open_app_update_api_open_apps__aid__patch","parameters":[{"name":"aid","in":"path","required":true,"schema":{"type":"string","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/webhook-deliveries":{"get":{"tags":["内部-开放平台"],"summary":"Webhook 投递记录","operationId":"api_webhooks_api_webhook_deliveries_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/audit-logs":{"get":{"tags":["内部-审计"],"summary":"操作日志","operationId":"api_audit_api_audit_logs_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/open/v1/price/quote":{"post":{"tags":["开放平台-报价"],"summary":"运费试算","operationId":"open_quote_open_v1_price_quote_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/open/v1/waybill/create":{"post":{"tags":["开放平台-运单"],"summary":"创建运单（支持幂等）","operationId":"open_waybill_create_open_v1_waybill_create_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/open/v1/waybill/batch-create":{"post":{"tags":["开放平台-运单"],"summary":"批量创建运单（≤50 票）","operationId":"open_waybill_batch_open_v1_waybill_batch_create_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/open/v1/waybill/{no}":{"get":{"tags":["开放平台-运单"],"summary":"查询自有运单","operationId":"open_waybill_query_open_v1_waybill__no__get","parameters":[{"name":"no","in":"path","required":true,"schema":{"type":"string","title":"No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/open/v1/track/{no}":{"get":{"tags":["开放平台-轨迹"],"summary":"查询轨迹（同客户查件）","operationId":"open_track_open_v1_track__no__get","parameters":[{"name":"no","in":"path","required":true,"schema":{"type":"string","title":"No"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/open/v1/waybill/cancel":{"post":{"tags":["开放平台-运单"],"summary":"取消未揽收运单","operationId":"open_waybill_cancel_open_v1_waybill_cancel_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/open/v1/webhook/test":{"post":{"tags":["开放平台-Webhook"],"summary":"向已配置地址推送一条测试事件","operationId":"open_webhook_test_open_v1_webhook_test_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"tags":["系统"],"summary":"健康检查","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}