list_talent

io.github.yzlee/opcmenu · Verify this server

【何时用】用户要的是**某一类人本人**而不是某个产品/服务时用：「帮我找个能写代码的」「有没有做出海的人」「找几个律师/财税顾问聊聊」。和 list_service_products 的区别：那边是「他卖什么」（产品目录），这边是「他本人是干什么的」（人的目录）；和 search_people 的区别：那边是语义搜，这边是结构化职业筛选，适合按类目扫一遍。 【组合链】items[].user.id → get_creator 看完整主页 → start_conversation 开聊（开聊走每日额度，撞 429 会直接返回「怎么办」的出口，别重试）；user.id → follow_creator 先关注不打扰；items[].company.slug → get_company。人卡唯一动作就是进个人主页，没有别的落点。 【口径/坑】 · 职业（items[].professions）是**机判闭集**：由资料/名片/自述跑分类器写入，不是本人勾选；一人最多两个主职业。没被判出职业的人不进这个目录，想找他走 search_people。 · chip 是职业的合并桶（比如律师/财税/HR 都并在「咨询·顾问」里），卡片上的职业胶囊是细粒度标签，两者不是一回事。 · **chip 全集以 GET /v1/talent/chips（首页下发）为准**：服务端按真实人数 ≥ 阈值才下发，这里的枚举只是合法值集合，不代表此刻每个都有人。传了没下发的 chip 会拿到很少甚至 0 条，不是报错。不传 chip 或传 all = 全部；传不认识的 key 按全部处理（不 400）。 · 只回真人（在册、已入驻、非测试号、非运营机构号）；返回里没有手机/邮箱/外链，要联系只能开聊。 · 规模小（百级），分页是 offset（nextCursor 就是下一次的 offset）。