docs(api): 重导 OpenAPI spec —— 跟上召回分配合入(70 paths)

CI 的 openapi-drift 闸只在 MR 和默认分支跑,合 test 时不会拦;
但合 main 时会 fail。在这里补掉,别把债留到下一刀。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>