V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
drymonfidelia
V2EX  ›  程序员

客户端 API Endpoint 格式用 /v2/users/userInfo /users/v2/userInfo /users/userInfoV2 哪个更好?为什么?

  •  
  •   drymonfidelia · 40 天前 · 1402 次点击
    这是一个创建于 40 天前的主题,其中的信息可能已经有所发展或是发生改变。
    9 条回复    2024-10-01 12:11:57 +08:00
    xiaogu2014
        1
    xiaogu2014  
       40 天前   ❤️ 2
    看你加 v2 的目的。
    如果是只更新 user 相关的接口。/users/v2/userInfo
    如果是全部接口都要更新。/v2/users/userInfo
    如果是你只要更新一个接口。 /users/userInfoV2
    XiLingHost
        2
    XiLingHost  
       40 天前
    除了#1 提到的以外,还有一个是如果你使用 /v2/users/userInfo 的形式对于服务灰度切换是更友好的,因为可以按路径前缀决定路由到特定的后端
    XiLingHost
        3
    XiLingHost  
       40 天前
    https://istio.io/latest/docs/concepts/traffic-management/ 比如这个例子里就是这样处理的
    BernieDu
        4
    BernieDu  
       40 天前
    我不懂服务端,但是见过几个都是第一种,比如 Docker Hub 的 api https://hub.docker.com/v2/repositories/
    qloog
        5
    qloog  
       39 天前
    标准格式:/v2/users/info
    uds9u32br
        6
    uds9u32br  
       39 天前
    /v2/users/info ,还有这里一定要 user(s)吗
    realpg
        7
    realpg  
       39 天前
    这三个 url 明显意义有较大的不同
    不存在可互换的可呢性
    还是结合架构
    flyqie
        8
    flyqie  
       38 天前 via Android
    /v2/user/info

    rpc 的话,v2.user.info
    ysc3839
        9
    ysc3839  
       38 天前 via Android
    大版本更新,很多东西不再兼容的情况,v2 放前面。小更新等情况,v2 放后面。
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   实用小工具   ·   2809 人在线   最高记录 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 21ms · UTC 11:39 · PVG 19:39 · LAX 03:39 · JFK 06:39
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.