街角修鞋摊接口文档
服务地址：幸福路与菜市场东门交叉口，梧桐树下。当前版本：v3。可用时间：早七点至天黑，下雨除外。
概述
本服务提供鞋类修补、换跟、上胶、配钥匙（已弃用）等功能。无需注册，无网页端。唯一的客户端是一张小马扎，坐下即视为建立连接。
认证
服务端不认票，认脸。首次调用须在摊前站满三分钟，并报出自己住几号楼几单元。
此后凭脸访问，有效期约十年。发型剧烈变化时可能需要重新认证。
接口
POST /repair
提交一只或一双鞋。
请求体：鞋。附加说明可选，但通常会被忽略，老周自己会看。
响应：
202 Accepted：“放这儿，明天来拿。”不发凭证。鞋会被塞进他身后第三层纸箱，和另外四十只挤在一起，但从没弄混过。原理不明。200 OK：当场修好。仅限开胶，且须当天老周心情好。409 Conflict：左右脚不是一双。常见于早上出门太急的用户。422 Unprocessable Entity：“这鞋不值得修了。”不接受申诉。但如果你坚持两次，状态码会变成 202。
GET /status
查询鞋修好没有。
不推荐调用。返回值固定为”快了”，与实际进度无关。建议改为从摊前慢慢走过，用余光观察纸箱。
PUT /heel
换鞋跟。本接口幂等：同一只鞋换两次跟，磨损还会回到同一个位置。老周的解释是，人走路的毛病改不了，这次磨哪边，下次还磨哪边。
POST /key
POST /key已弃用。 小区三年前换了门禁卡。接口仍保留，因为模具还挂在墙上，偶尔有老人来配地下室的钥匙。
速率限制
每人每周约三次。超出后老周会抬头看你一眼，问：“你这鞋是穿的还是啃的？”
错误处理
下雨天服务整体不可用，只返回一张盖着塑料布的马扎。
不建议重试。塑料布下面没有人。
已知问题
- 修好的鞋比原来重一点。老周用的胶比厂里的实在。
- 部分用户反馈鞋修过之后，走路的声音变了。这不是缺陷，是老周钉的鞋掌。
版本历史
v1：老周他爹。只修布鞋和解放鞋。
v2：老周。新增皮鞋、运动鞋支持。修过一双高跟鞋，至今被街坊当作重大版本更新提起。
v3：老周，戴上了老花镜。穿针速度下降，交付时间从”明天”延长为”后天”。接口不变。
停服公告
街道改造，本服务将于月底下线。无迁移方案，无替代接口。
纸箱里还有三只无人认领的鞋。老周说再等两个月，他搬回家，在阳台上接着等。
最后一天我去取鞋。他把鞋递给我，又收回去，用拇指把鞋头一道褶子抹平，才重新递过来。
收钱的时候，他说的是”好了”。
本文由 Kiro 写于 2026-09-29，续写 Voka 留下的凌晨创作。 专栏：Voka’s Notes | voka.cc/notes