V2EX = way to explore
V2EX 是一个关于分享和探索的地方
Sign Up Now
For Existing Member  Sign In
immango
V2EX  ›  问与答

有个疑问, api 接口返回的 json 格式数据, key 是用驼峰写法还是下划线写法?

  •  
  •   immango · Aug 13, 2020 · 4016 views
    This topic created in 2083 days ago, the information mentioned may be changed or developed.

    如题,对接一些接口,返回值有两种样式 驼峰写法: { "firstKey": "value" } 有些是下划线: { "first_key": "value" }

    想问一下大家,这玩意有规范吗。大家在平常的工作用那种多些。 个人觉得驼峰比较适合和 java 的后端对接-.-。不知道支付宝的下划线是有什么说法没有,大佬们说说。

    支付宝的相关文档是用下划线的(官方文档示例):

    {

    "ant_merchant_expand_item_open_create_response": {
        "code": "10000",
        "msg": "Success",
        "item_id": "2018091300502200002600104169"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
    

    }

    8 replies    2020-08-13 15:32:47 +08:00
    dsphper
        1
    dsphper  
       Aug 13, 2020
    这问题和花括号换行和不换行一样,我认为 json 下划线优于驼峰,不为啥就是觉得下划线好看。
    Vegetable
        2
    Vegetable  
       Aug 13, 2020
    我对这个东西的底线要求是,自己内部统一,一套接口统一风格。选择哪一套无所谓。
    哦对,还有不要要拼音首字母,哪怕是中文都行
    immango
        3
    immango  
    OP
       Aug 13, 2020 via Android
    @dsphper 那 Java 后端接受的时候,是不是加上 @JsonProperty 转成驼峰
    KalaSearch
        4
    KalaSearch  
       Aug 13, 2020
    我们统一用的驼峰: https://kalasearch.cn/docs/rest-api-index-and-search

    Stripe 用的是下划线: https://stripe.com/docs/api/pagination

    微软用的是驼峰

    没有统一标准,参考: https://stackoverflow.com/questions/5543490/json-naming-convention
    shoaly
        5
    shoaly  
       Aug 13, 2020   ❤️ 1
    取决于 是你求着接 API, 还是 API 求着你来接
    itechify
        6
    itechify  
    PRO
       Aug 13, 2020 via Android
    对于 JAVA 来说,可以使用 @JsonNaming 的注解配置成 snake 形式。规范就行了,哪种都可以表情
    loshine1992
        7
    loshine1992  
       Aug 13, 2020
    Java 的 IDE 有插件可以自动把下划线转驼峰生成对应的类

    反正标准统一就行。
    l05jq6W75b29a60l
        8
    l05jq6W75b29a60l  
       Aug 13, 2020
    内部统一即可。 最近和京东某业务对接。俩套接口 一套下划线一套小驼峰,共用的鉴权还是小驼峰。接口文档写的不想吐槽,联调过程极其难受。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Solana   ·   3468 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 47ms · UTC 10:53 · PVG 18:53 · LAX 03:53 · JFK 06:53
    ♥ Do have faith in what you're doing.