背景 在团队两年多陆续负责了几个项目的开发上线已经代码的review,特别是对老项目的重构过程中,发现之前的API设计是没有任何规范和约定的,不同的开发同学有不同的习惯,因此需要一套规范去约定,现在分享一下我们目前试运行的一套规范,一起交流完善下. WebAPI开发流程 第一步首先设计接口文档,公司内部有一套自研的多人协作文档系统,可以很好的做到这一步,并能很好的做好版本控制.如果公司内部没有可以基于showdoc搭建一套 第二步有技术负责人确认接口以及字段的命名规范 第三步找对应API对接人,…

文档 规范的文档对接口的开发有着至关重要的作用,规范的文档能够使 双方对接口的定义以及接口的参数都有一个明确的概念,便于沟通和联调. 在接口的开发过程中,为了保证传递参数的传递的私密性,参数传输是需要加签的,接口提供方提供了一种验签规则,接口的调用方提供合适的参数后通过加签的操作以参数的形式传输给接口的提供方 下面提供一种验签的思路 step1: 拼接参数字符串将除sign以外的请求参数(包括标准参数,除非有特别说明)按照参数名称的字典升序排列,然后按此顺序,将”参数名＝参数值”用”&”符号连接…

前言 踩过了一段时间的坑,现总结一下,与大家分享,愿与大家一起讨论. Restful WebApi特点 WebApi相较于Asp.Net MVC/WebForm开发的特点就是前后端完全分离,后端使用WebApi直接针对资源进行暴露,大部分的业务转移到前端进行.前端可以采用Html页面或各平台的原生程序开发,非常灵活. 我们采用的是WebApi+angularjs/WPF的方式开发. 设计思想 目前就算使用Asp.net MVC开发,为了用户体验也需要使用Ajax来异步加载数据,而Html5的单页…

随着互联网的兴起,各行各业的需求都在不断的增加.随着业务的扩大,企业给用户发送短信验证码的业务,也是如火如荼.在这里,calvin给各位开发者推荐阿里云短信平台.原因有二:1.接入较简单,开发成本低 2.非常稳定,短信可达率99%.        OK,那么接下来我们就可以开发阿里短信接口吧.主要包括两个步骤,第一个是前期准备,包括注册阿里云账号,获得access_key和access_secret,并且申请短信签名和短信模板.第二个步骤则是引入阿里短信服务的SDK,并正式开发. 一.前期准备…

统一下单入口 调用该方法入口: public void WxPayAPI() { //string PayPrice ="99.9"; ////订单号 //string Payorder =GenerateOutTradeNo(); //支付金额 string PayPrice = Request.GetString("payprice").ToString("filtersql"); //支付单号 string Payorder = Reque…

随笔分类 - Restful WebApi开发实践   C#对WebApi数据操作 摘要: ## 目标简化并统一程序获取WebApi对应实体数据的过程,方便对实体进行扩充.原理就是数据服务使用反射发现数据提供者,处理好泛型就行.相关传送门:[Restful WebApi开发实践](http://www.cnblogs.com/zhang740/p/3865311.html)先来看下最后的请...阅读全文 posted @ 2014-07-28 08:59 SuperEVO 阅读(150) | 评…

GitHub:https://github.com/iccb1013/Sheng.WeixinConstruction因为个人精力时间有限,不会再对现有代码进行更新维护,不过微信接口比较稳定,经测试至今没有变化,功能依然全部可用,你可以在此基础上,二次开发,完成你的业务功能,也可以抽取本平台中的代码复用在你的项目中,请遵循 MIT 开源协议保留我的版权声明和网站链接即可. GitHub:https://github.com/iccb1013/Sheng.WeixinConstruction.We…

05.产品前端架构 第1章--协作流程 WEB系统 角色定义 协作流程 职责说明 第2章--接口设计 概述 接口规范 规范应用 本地开发 第3章--版本管理 见 Java开发工程师(Web方向) - 01.Java Web开发入门 - 第5章.Git 课堂交流区: 分布式版本控制(DVCS) 对比集中式版本控制系统(CVCS) 由于Git的持续火热, 对于DVCS与CVCS的争论和对比越来越多了, 似乎很多文章都倾向于这个观点:"Git这种DVCS 要比SVN这些CVCS要优越"  实…

前提: 最近,有不少同学又问到,Aries里如何提供WebAPI接口? 针对这个问题,今天给顺路写个教程,其实呢,很简单的. 方式一:直接用WebService提供接口. 用这种方式,直接添加接口就可以了,Aries只是默认处理了.html后缀的请求.对于WS的asmx后缀是没有影响的,所以传统怎么添加就怎么添加. 方式二:单独用Taurus.MVC写一个接口项目. 用这种方式,就是把接口独立成一个项目,然后通过IIS部署成子应用程序就可以了. 只是部署成子应用程序的时候,需要注意一下子目录和根…

最近在研读一本书<JavaScript设计模式与开发实践>,进阶用的. 一.高阶函数 高阶函数是指至少满足下列条件之一的函数. 1. 函数可以作为参数被传递. 2. 函数可以作为返回值输出. 1)高阶函数实现AOP AOP(面向切面编程)的主要作用是把一些跟核心业务逻辑模块无关的功能抽离出来,这些跟业务逻辑无关的功能通常包括日志统计.安全控制.异常处理等. 把这些功能抽离出来之后,再通过“动态织入”的方式掺入业务逻辑模块中. 这样做的好处首先是可以保持业务逻辑模块的纯净和高内聚性,其次是可以很…