如何合理设计API接口?

这篇具有很好参考价值的文章主要介绍了如何合理设计API接口?。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

本规范仅适用于由服务器端发起调用请求、POST提交数据以及GET请求文本数据结果的API,统一采用UTF-8编码规则,采用JSON格式响应。

URL定义
API 服务接口应提供REST风格的HTTP(HTTPS) 接口:
{protocol}://{domain}:{port}/{ app}/{controller}/{action}?{query}
变量 含义 示例
protocol 接口协议 HTTP、HTTPS
domain 网关ip地址或者网关域名 api.xxx.com
port 网关端口号 80、8080
app 应用名 SMSManage、UserManage等
controller 控制器名 UserInfo、DepartmentInfo
action 操作方法 CREATE、SELECT、UPDATE、DELETE等
query由系统级参数部分和具体API调用参数部分组成,以key1=value1&key2=value2&…表示。
对于采用POST请求的Open API,query部分则是在POST请求体里。

请求头格式
名称 必填 描述
Content-Type 是 application/x-www-form-urlencoded;charset=utf-8;
或application/json;charset=utf-8;

系统级请求参数
名称 必填 描述
appid 是 请求账号
timestamp 是 Unix时间戳,即从1970年1月1日0时0分0秒开始所经过的秒数(安全验证有效期60秒,防replay攻击)
sign_type 否 安全验证方式,默认为MD5。
sign 是 加密字符。

应用文章来源地址https://www.toymoban.com/news/detail-669865.html

到了这里,关于如何合理设计API接口?的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • 解决电脑连接HC-06出现的疑难杂症

    1.HC-06接电信号灯不亮 一开始用面包板,32单片机给HC-06供电,发现HC-06信号灯不亮。 考虑到供电稳定性的问题,暂时用ST-LINK给HC-06供电,信号灯开始闪烁。 2.使用CH340接HC-O6发送AT指令没反应 波特率初始默认9600,连接后发送框不要打回车,清空后再敲入AT发送,即可收到回复。

    2024年04月26日
    浏览(42)
  • 使用git遇到的各种疑难杂症之解决办法

    git init 初始化本地git仓库,会生成.git/文件夹 git add . 添加文件到暂存区,文件开始被跟踪,文件修改后也要重新跟踪 git commit -m \\\'说明文字\\\'  将暂存区的文件,提交到本地仓库 以上两步,可以合成一步 git commit -a -m \\\'说明文字\\\' git log 查看日志,罗列所有提交过的历史记录,根据

    2024年04月29日
    浏览(41)
  • UE 各类疑难杂症/快捷键/细节/优化方式

    链接: link 链接: [link](https://blog.csdn.net/aoxuestudy/article/details/124902503?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522166358838316800184178729%2522%252C%2522scm%2522%253A%252220140713.130102334…%2522%257Drequest_id=166358838316800184178729biz_id=0utm_medium=distribute.pc_search_result.none-task-blog-2 all sobaiduend~default-1-124

    2024年02月04日
    浏览(65)
  • 值得深思的八个自动化测试疑难杂症

    去年有写过两篇博客,分别是浅谈UI自动化测试和浅谈接口自动化测试,都是一些基础的方法论的内容,今年转岗专门做自动化测试,有了很多新的发现,当然,也遇到了很多的挑战。 遂重开一篇博客,聊聊最近做自动化测试遇到的一些挑战,以及自己的解决方法和一些思考

    2024年02月11日
    浏览(48)
  • Toaster - Android 吐司框架,专治 Toast 各种疑难杂症

    https://github.com/getActivity/Toaster 想了解实现原理的可以点击此链接查看:Toaster 源码 如果你的项目 Gradle 配置是在 7.0 以下,需要在 build.gradle 文件中加入 如果你的 Gradle 配置是 7.0 及以上,则需要在 settings.gradle 文件中加入 配置完远程仓库后,在项目 app 模块下的 build.gradle 文件

    2024年02月07日
    浏览(49)
  • 【故障排查】10分钟解决Quartz重复调度的疑难杂症

    我司使用Apache DolphinScheduler作为调度框架很久了,感兴趣的小伙伴可以看看这些干货文章: 因为之前监控到会出现重复的调度的问题,所以此文记录排查重复调度问题的全过程,希望对社区其他的小伙伴能够起到抛砖引玉的作用! 注:本文使用的DolphinScheduler 3.1.1的版本。 数

    2024年03月18日
    浏览(46)
  • 微信小程序真机调试技巧,解决各种疑难杂症

    也许你调试的时候,会使用到真机调试或者预览模式或者体验版模式,这些模式都有可能出现意想不到的bug问题,这时候调试模式就非常非常重要了,特别是给领导看的时候,在领导手机上出现bug了,这时候你是不是非常紧张非常不安,别慌,打开小程序的调试模式: 在小程

    2024年02月04日
    浏览(85)
  • 【C语言疑难杂症】“无法启动程序......系统找不到指定的文件”

    原因:创建的项目和源文件的路径不同(两者在不同的地方) 解决方案:查看两者的目录,然后把源文件移动到项目目录 1、查看项目的目录: 项目——项目属性——配置属性——常规——输出目录——编辑   2.查看源文件目录: 项目——项目属性——属性配置——链接器

    2024年02月02日
    浏览(43)
  • 手把手kubernetes本地化部署(含疑难杂症排查解析)

    公众号: MCNU云原生 ,文章首发地,欢迎微信搜索关注,更多干货,第一时间掌握! Kubernetes是一个容器编排系统,用于自动化应用程序部署、扩展和管理。本指南将介绍Kubernetes的基础知识,包括基本概念、安装部署和基础用法。 一、什么是Kubernetes? Kubernetes是Google开发的开

    2024年02月01日
    浏览(81)
  • Python爬虫-requests.exceptions.SSLError: HTTPSConnectionPool疑难杂症解决(1)

    前言 本文是该专栏的第7篇,后面会持续分享python爬虫案例干货,记得关注。 在爬虫项目开发中,偶尔可能会遇到SSL验证问题“ requests.exceptions.SSLError: HTTPSConnectionPool (host=\\\'www.xxxxxx.com\\\', port=443): Max retries exceeded with url ... ”。亦或是验证之后的提示警告“ InsecureRequestWarning: Un

    2024年02月05日
    浏览(45)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包