美文网首页
设计细节:接口输入参数要通用化

设计细节:接口输入参数要通用化

作者: kkyao | 来源:发表于2017-12-15 09:12 被阅读0次

最近在定义一个接口时,需要根据不同的渠道类型返回不同的城市范围,大致的需求是如果是手机客户端则返回中国全部城市以及全球各个国家的TOP10城市,如果是web页面的话,则只返回中国热门城市以及全球各大洲的热门城市。如下:

是否返回 手机客户端 web页面
中国热门城市 Y Y
中国全部城市 Y N
各大洲热门城市 Y Y
各国家TOP10城市 Y N

需要在接口请求参数上进行区分,有两种方式分别如下:

  • 方式一:增加一个渠道类型参数(标识是”手机客户端“还是”web页面“)
  • 方式二:增加两个参数(“是否返回中国全部城市”和“是否返回各国家TOP10城市”)

从调用者角度,会觉得方式一比较方便明确;但从长远演进考虑,还是方式二会更佳,在这种方式下,前台和后台服务各自专注于自己的能力,不需要相互耦合逻辑,同时你会发现今后渠道类型越来越多的情况下(H5/Pad/API等),各渠道的差异五花八门,通过方式二后台接口将会更加通用。

相关文章

  • 设计细节:接口输入参数要通用化

    最近在定义一个接口时,需要根据不同的渠道类型返回不同的城市范围,大致的需求是如果是手机客户端则返回中国全部城市以及...

  • python-接口基础知识

    接口基础 一,什么是接口? 1)接口,黑盒子,一边输入参数,一边输出参数;url带上地址,接口返回地址;输入参数-...

  • 接口测试用例设计

    1,输入参数测试:针对输入的参数进行测试,也可以说是假定接口参数的不正确性进行的测试,确保接口对任意类型的输入都做...

  • 接口测试范围

    1、接口入参 参数不同类型 参数必填、非必填 参数为空 参数正确值 参数不传是否有默认值 参数输入上限 2、接口出...

  • 后端逻辑测试(接口测试) 测试用例设计思路

    作者:Gakki 01. 从输入参数进行考虑设计 优先级 —— 针对所有接口1.暴露给其他系统、第三方调用的接口2...

  • .netCore webApi相关

    controller: 输入参数模型绑定接口的输入参数就是通过模型绑定将 HTTP 请求中的值映射到参数中,模型绑...

  • fiddler接口测试用例设计

    1、输入参数测试:针对输入的参数进行测试,或者说是假设接口参数不正确进行测试,确保对任意类型输入都做了处理(1)输...

  • 接口设计细节

    1、list返回值,如果为空,返回空数组,而不是null; 2、get返回值,如果为空,返回null;

  • Python函数参数匹配模型通用规则keyword-only参数

    概述 Python3对函数参数的排序规则更加通用化了,即Python3 keyword-only参数,该参数即为必...

  • 硬件设计流程

    1. 需求分析 分析系统的需求,列出主要参数,如:输入电源电压,整机功率,接口,成本 2. 方案设计 选型,画出框...

网友评论

      本文标题:设计细节:接口输入参数要通用化

      本文链接:https://www.haomeiwen.com/subject/pjjrwxtx.html