现有接口对接

汽车商机系统,车厂经常需要开展各种各样的活动吸引客户到店试驾购车,获得的线索除了可以由运营人员手动批量上传到系统之外,因此我们系统还准备了一个通用接口,方便对接和汇总车厂开展各种渠道,自动导入线索。作为一名不写代码的业务员,如何组织程序猿哥哥完成接口开发?下面是本人根据之前的对接经历进行的总结。

场景:一方已有现成接口,外部业务来调用该接口传数。被调用方=A,调用方=B

1、对接沟通

A把现有的接口文档发给B,与B沟通清楚要对接的是哪些数据,包括但不限于以下内容:

(1) 参数(线索要传哪些值,注意大小写) 、传递类型 、哪些必传、 必传项是否有特定值、可接收名称还是只接收ID

(2)提供用于做映射的字段ID和code(通常这些ID不是限定值,如经销商id,线索来源id,后续有新增需要追补。注意:是否分测试ID和正式ID,别给错了增加沟通成本)

(3)B把双方的ID 、code 一一对应后,把表发回,这样双方都有同一份映射表,传数的时候就以这个表作为依据,把数据存到对应的数据表里。(例如B传过来code,A根据映射规则找到对应的ID,把该ID下的某个值做更新)

2、接口联调测试

(1)ip加入白名单:B提供请求接口的ip地址,A将其加入ip白名单;

(2)提供测试接口:A开通测试环境url、key、及必要的id值(专门指定的来源id),发给B。(一般会在写在接口文档上,key:public_key、private_key用于发送前加密,发送后解密);

(3)A接口配置:调用接口时需配置url、header名称、header值、resposen body等;

(4)一方在测试环境创造几条原数据、变更数据,一方做核对数值传输是否正常。如传数正确无误则表示接口已通;

(5)若测试异常:如遇到调用异常,传数不对,甚至接口不通的情况。B发送请求参数的日志,A做查询。一般原因包括但不限于:地址错误、传递的参数不对、未传必填参数、key大小写不分或不对,检查白名单缺失等等。

3、正式环境联调

(1)测试环境联调通过后,开放生产环境接口url、key、及必要的id值,发给对方调用。

(2)(3)跟测试环境的一致

4、接口跟踪维护

接口通了之后,但并非就可以高枕无忧了,还需日常的维护。如发现接口异常,需要撒黄芳配合操作及查找原因。例如:

(1)出现传的数丢失的情况,双方可以调取日志进行查询核对找出原因,可能的原因是临时通行中断,网络动荡,人为误操作,数据未传等。日志有专门的统计库,一种日志下面会有有很多个日志供查看。(一般这种情况下,双方都不希望是自己的问题,所以想打别人的脸之前,先检查自己这边是否没有问题,否则尴尬哈哈)

(2)执行补推机制,把丢失的数据再补推一遍。

域名或其他有变更,在新域名起效的前1~2个月,应邮件通知调取方切换为新的域名地址调用接口以获取数据。考虑到会调用方延迟更换,旧的域名应于新域名起效后延长使用一段时间,待对方把切换完毕后再关闭。

最后,希望对你有所帮助,大神轻喷~

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,013评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,205评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,370评论 0 342
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,168评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,153评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,954评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,271评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,916评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,382评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,877评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,989评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,624评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,209评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,199评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,418评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,401评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,700评论 2 345

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,599评论 18 139
  • 1. Java基础部分 基础部分的顺序:基本语法,类相关的语法,内部类的语法,继承相关的语法,异常的语法,线程的语...
    子非鱼_t_阅读 31,581评论 18 399
  • 夏天,我这个北方人到南方——绍兴;。第一次来到绍兴,烟雨蒙蒙。人一生会行经哪里,不是能安排的,特别是这些年...
    莉双阅读 722评论 3 6
  • “夜上海,夜上海,你是个不夜城,华灯起,歌声响,歌舞升平” “农历大年二十八,上海各大车站迎来春运客运高峰……” ...
    我是阿桑阅读 255评论 0 1
  • 用真诚、用智慧可以感动一个人,用道理、用行动可以说服一个人。说服别人是一个本事,说服自己是一件难事,或者为...
    冰夫阅读 205评论 0 0