ICode9

精准搜索请尝试: 精确搜索
首页 > 其他分享> 文章详细

对外开放的通用接口设计

2019-04-20 21:57:35  阅读:230  来源: 互联网

标签:通用 平台 系统 接口 文档 第三方 对外开放


     需求:以自己当前的系统作为一个平台,提供一下接口对外开放。其他接入我们对外开放的平台或系统则统称为第三方平台。

如果想要提供一套统一的接口,即可对接各种各样的第三方平台的话,就需要将对外的接口做成通用接口。

     由于各平台的差异性,平台A:酒店系统的,平台B:商城系统的,平台C:某物品零售系统的。 由此可见第三方的不同系统的订单表字段以及字段的意义都是千差万别的。

    那么,如何处理这些差别很大的不同订单,将他们提交过来的信息处理成通用接口呢?

    1. 首先,梳理一下他们的共同点,且是必须的内容。那么我们定义一个通用的订单表,可以有以下必填字段,比如:

     

    2.  然后,针对不同第三方的差异性,分别提供不同的文档,以满足该第三方的订单内容。注意:这里只是提供不同的文档而已,事实上他们对接的都是同一个接口。比如:对于平台A:

           

            但实际上,这些对应到通用表中,可能是分别对应 field1~~field11,即通用表中定义了11个字段来适配提交过来的信息。

     3.  如果是平台B对接该接口的时候,如果提交了20个字段过来,那么可能对应的字段是 field1~field7,   field13~field18, field22~field30.。 反正就是类似的这样处理。但是要注意,不同平台的对应字段,自己对内要提供一份文档说明。

     4. 只要做到以上几点,基本上通用接口的雏形就出来了,剩下的就是一些接口调用安全方面的校验。

         

        

标签:通用,平台,系统,接口,文档,第三方,对外开放
来源: https://blog.csdn.net/qq_33045443/article/details/89423437

本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享;
2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关;
3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关;
4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除;
5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。

专注分享技术,共同学习,共同进步。侵权联系[81616952@qq.com]

Copyright (C)ICode9.com, All Rights Reserved.

ICode9版权所有