首页
学习
活动
专区
圈层
工具
发布
    • 综合排序
    • 最热优先
    • 最新优先
    时间不限
  • 来自专栏cloudskyme

    跟我一起云计算(6)——openAPI

    供第三方开发者使用,这种行为就叫做开放网站的API,所开放的API就被称作OpenAPI(开放API)。 腾讯社区开放平台、腾讯微博开放平台、WebQQ开放平台等) 3、360安全中心(360应用开放平台、360软件开放平台、极速浏览器应用开放平台等) 4、新浪(新浪微博开放平台、SAE) 5、人人网开放平台 6、 从图中可以看出,人人网开放平台大概分为三个层次,共同为最上层的各种形式的第三方应用程序提供服务: Core Service Layer: 实现了人人网对外提供的最底层的API,定义好了接口参数和调用流程 各个Rest API的接口参数定义详见Rest API。 ,应用编程接口)开放出去,供第三方开发者使用,这种行为就叫做开放网站的API,所开放的API就被称作OpenAPI(开放API)。

    3.5K40发布于 2018-03-20
  • 来自专栏peakxie

    OpenAPI初探

    很快发现openapi可以通过写标准的yaml,可以通过yaml生成代码和文档。 Openapi yaml的格式如下: 1.png 编辑好yaml,使用如下命令: docker run --rm -v ${PWD}:/local openapitools/openapi-generator-cli 也许指定的模板不符合你的框架,也可以下载开源的代码生成工具:https://github.com/OpenAPITools/openapi-generator 4.png 在模板目录下,增加对应的mustache

    5.6K60发布于 2019-08-29
  • 来自专栏三木的博客

    OpenAPI 概要

    OpenAPI是什么? OpenAPI被用来描述基于HTTP的API,是目前被广泛接受和使用的API工业标准。 格式: JSON 或者 YAML 最小化结构: openapi: 3.1.0 # OpenAPI版本 info: title: A minimal OpenAPI document version "X", "O"] parameters对象 paths: /users/{id}: get: parameters: - name: id # 必须有的,定义参数名 in: path # 必须有的,定义参数的来源,可以是 path, query, header中的一个 required: true # 可选的 schema And an extra one. description对象中也支持markdown的语法 OpenAPI Generator OpenAPI Generator可以根据OpenAPI的API描述文件自动生成客户端

    1K10编辑于 2024-10-09
  • 来自专栏小二十七

    拥抱 OpenAPI 3: springdoc-openapi 食用指南

    概述 使用 springdoc-openapi 可以快速为 springboot 项目生成规范的 API 文档,具体使用步骤如下: 依赖配置 在 pom.xml 加入内容,即可开始使用: <dependency > <groupId>org.springdoc</groupId> <artifactId>springdoc-openapi-ui</artifactId> <version springOpenAPI() { return new OpenAPI() .info(new Info() 的理由如下: springdoc-openapi 是 spring 官方出品,与 springboot 兼容更好(springfox 兼容有坑) springdoc-openapi 社区更活跃,springfox 已经 2 年没更新了 springdoc-openapi 的注解更接近 OpenAPI 3 规范 综上所述,我个人还是更加推荐使用 springdoc-openapi 来自动化你项目的 API 文档

    8.5K30编辑于 2022-11-11
  • 来自专栏快乐阿超

    openapi-generator

    ——林则徐 分享一个开源项目:openapi-generator 可以生成对外的api 官方文档:https://openapi-generator.tech/ 还有教程

    1.3K20编辑于 2023-05-11
  • 来自专栏程序员

    DRF自动生成OpenAPI文档

    DRF自动生成OpenAPI文档 API schemas是非常有用的,可以帮助我们生成接口文档以及可与API交互的动态客户端。 Django REST Framework支持自动生成OpenAPI schemas,但是目前支持的不是非常完善,需要手动修改的地方过多。 Schemas中的描述,description是来自于序列化器的文档字符串,而各个字段的title是来自于字段的label,带有*的意味着是必传的字段,除此之外,字段的其它描述是直接取自序列化器字段中的参数 # 返回错误信息 return Response({'msg': '保存失败'}, status=400) 对于HTTP Body中的内容,都在序列化器中描述了,但是对于URL参数 的规范,有一篇不错的文章,可以看看OpenAPI 规范摘要。

    3.2K20编辑于 2021-12-21
  • 来自专栏生如夏花绚烂

    Es6参数展开&剩余参数

    Es6中我们可以通过... +变量的方式存储函数剩余的参数,该变量是包含剩余参数的数组 function sum(a,...num){ console.log(a); console.log(num); } sum (1,2,3,4,5,7) 可以看到sum函数只明确接收一个a ,其他的参数不确定要传多少,这里就通过...num的形式使num接收剩余的参数 在es6之前我们接收不确定参数时我们通过arguments function sum(){ console.log(arguments) } sum(1,2,3,4,5,7) 有了es6这个特性后我们可以做如下案例 求一个数和任意数的和 function =[1,2,3] console.log(...arr) //1 2 3 由此我们可以想到...可以直接拼接数组 //以前的方法 let arr =[1,2,3] let arr2 = [4,5,6]

    78820编辑于 2022-09-08
  • 来自专栏小二十七

    OpenAPI 3.0 规范-食用指南

    概述 OpenAPI 3.0 规范由 8 个根对象组成: openapi info servers paths components security tags externalDocs OpenAPI 中来验证你的 OpenAPI 文件是否符合规范,以下我们就主要介绍 8 个根对象的使用和扩展方法 openapi 对象 openapi 是最简单也是最基础的属性,我们为 OpenAPI 添加第一个根对象属性 ,指定使用的规范版本: openapi: "3.0.2" 然后继续补充信息 openapi: "3.0.2" info: title: openAPI Demo version: '1.0' ,描述如下,( requestBody 描述不在此列包含系列属) name:参数名称 in:参数出现的位置,通常是 header,path,query,cookie description:参数的描述( 支持 markdown) required:必填项 deprecated:是否弃用 allowEmptyValue:允许提交空值 style:参数序列化方式 explode:与数组相关的参数 schema

    15.6K31编辑于 2022-11-11
  • 来自专栏泛泛聊后端

    Spring Boot使用OpenAPI规范

    常规的方案就是使用OpenAPI规范,它的前身即大名鼎鼎的Swagger。 注解 OpenAPI 是Swagger v3 ,所使用的注解跟原来的有所区别。 描述接口参数 @Schema @ApiModel 描述模型 @ApiResponse @ApiResponse 描述返回的结果,包含返回码,信息等 交互式文档 ip:port/swagger-ui/ 点开其中一个方法,有具体的描述,方法的用处,参数和返回等上述注解中所定义的内容。 ? 点击右上角的【try it out】按钮,则可以出现一个模拟请求的交互界面。 ? 填入对应的参数,然后点击【Execute】按钮即可发起请求,然后在Responses看到对应的结果。同时也有Curl和Request URL给出,可以比较方便地复制到其他地方使用。

    4.5K20发布于 2020-10-23
  • 来自专栏大宇笔记

    ES6 函数参数(默认参数、结构)

    重来没有系统的学过es6,感觉语法和swift 、java、python等语言差不多,今天给我上了一课。 缘起 ---- 今天看了一个函数,愣是看的有点蒙。 clone ({ zindex = this.commonStyle.zindex + 1 } = {}) { } 最后终于弄明白了,写点总结 ES6函数参数 ---- 1、默认值 这个没什么说的,就是传入 3、无限参数 大部分语言都支持 function wuxianP(...params) { console.log(params); } wuxianP(1) wuxianP(1,'1') wuxianP

    1.1K20发布于 2021-04-30
  • 来自专栏全栈程序员必看

    openwrt外网web管理_OpenAPI

    将传入一个名为instance的参数,这个参数代表当前 OpenERP 的 Web 客户端实例, 包含了所有相关当前会话数据,以及所有 Web 模块的变量。 $el 当你在部件中重载init()时,必须以父部件作为第一参数传入,并调用传入给this. Widget.trigger(event_name [ , …]) 方法的第一个参数是待触发的事件名,也接受任何数量的其他参数。这些参数将被传递到所有的事件侦听器。 当func被调用时,trigger()的其他参数会传递给它。 6)所有交互式组件(屏幕上显示信息的组件、或拦截DOM事件的组件)都必须继承自部件,正确的执行、使用它的API,符合生命周期。 版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。

    7.2K10编辑于 2022-11-17
  • PostIn从入门到精通(6) - 如何导入swagger、OpenApi数据,实现数据迁移

    本文将详细介绍如何将swagger、OpenApi数据迁移到PostIn,以实现平滑切换。 3、导入OpenApi 3.0/3.1接口进入项目详情后,点击接口管理,进入接口列表。点击左侧接口列表“+”号,选择导入。选择到如类型为OpenApi。拖拽或者点击上传区域上传导出文件。 至此,成功将Swagger、OpenApi接口迁移到PostIn。​

    24465编辑于 2025-11-27
  • 来自专栏飞鸟的专栏

    ES6 rest参数

    在ES6(ECMAScript 2015)中,引入了rest参数的概念,它允许函数接收不确定数量的参数,并将它们作为一个数组进行处理。rest参数提供了一种简洁和灵活的方式来处理可变参数的情况。 注意事项:rest参数只能是函数的最后一个参数。之后的参数不能被当作rest参数。rest参数是一个真正的数组,可以使用数组的方法和属性进行操作。 与arguments对象的比较:在ES6之前,我们可以使用arguments对象来处理不确定数量的参数。然而,arguments对象是一个类似数组的对象,但它不是一个真正的数组,没有数组的方法和属性。 结合其他参数使用:rest参数可以与其他参数一起使用,包括普通参数和默认参数。 通过结合rest参数和普通参数,我们可以在函数调用时传递不确定数量的names参数,并在函数体中对它们进行处理。

    46920编辑于 2023-05-22
  • 来自专栏数据库干货铺

    Elasticsearch 6 重要参数配置

    采用zip或tar.gz的二进制包方式安装的ES,需要配置一系列参数,通过阅读官方文档了解到其中重要参数的配置及其说,下面将逐步进行了解。 一、 ElasticSearch参数配置 1. data和logs路径配置 如果使用.zip或.tar.gz归档文件,则数据和日志目录是$ES_HOME的子文件夹。 可解析的)其中任意一种均可; discovery.zen.minimum_master_nodes 设置的值建议设置为 (master_eligible_nodes / 2) + 1 6. 如果此路径不适合接收日志,则应修改jvm.options 条目-XX:ErrorFile=… 二、 重要的系统参数配置 1 . ulimit设置 建议设置为65535,修改的2种方式如下: a) 修改/

    1.9K30发布于 2019-08-08
  • OpenAPI 文档代码生成工具

    前言 OpenAPI 文档是基于 OpenAPI 规范(OpenAPI Specification, OAS)撰写的,主要用于描述 RESTful API 的一种标准化方式。 而 OpenAPI 代码生成工具是一类基于 OpenAPI 规范自动生成代码的工具。通过这些工具,开发者可以快速生成符合规范的客户端 SDK、服务器端代码或文档,而无需手动编写固定格式的代码。 主流 OpenAPI 代码生成工具 以下是几款流行的 OpenAPI 代码生成工具的简要介绍: OpenAPI Generator OpenAPI 生成器允许在给定 OpenAPI 规范(支持 2.0 SDK(使用 OpenAPI(以前称为 Swagger)规范定义)来简化您的构建过程,以便您的团队可以更好地专注于 API 的实施和采用。 选择 OpenAPI 代码生成工具时,可以从以下几个方面入手: 语言支持: 根据项目使用的编程语言选择支持相应语言的工具。

    1.7K107编辑于 2025-01-04
  • 来自专栏后台技术汇

    OpenAI的 OpenAPI 规范简介

    背景 OpenAI OpenAPI 规范是由 OpenAI 官方发布的一个开源项目,旨在为 OpenAI API 提供标准化的接口定义。 开发者按照OpenAI API规范(RESTful架构)组装请求参数,包括: ✓ 模型选择(如GPT-3.5/4) ✓ 输入文本(prompt) ✓ 参数配置(temperature, max_tokens 验证请求合法性(身份鉴权、参数校验)。 分配计算资源,将请求传递至对应模型服务。 服务器处理请求 模型处理/文本生成 构建API响应 请求报文-body参数 请求body提供了多个参数和选项,用于控制生成结果的质量、多样性和长度等特性。 下面是一个curl案例: 常见的一些参数是:Temperature/Top_k/Top_p 其他的可选参数: 请求报文-messages 参数 messages 必须是消息对象 ( message object

    5.4K10编辑于 2025-07-24
  • 来自专栏Java面试教程

    微信开发之openApi管理

    容我想想 了不起:哈哈,那还是我来给你讲一讲微信openApi管理吧! 正文: 今天了不起就通过三方面讲一下api管理。 1.查询Api调用额度: 官方网址:https://developers.weixin.qq.com/miniprogram/dev/OpenApiDoc/openApi-mgnt/getApiQuota.html 第一个参数就是调用接口凭证,第二个参数就是接口请求地址。出参包含:上面我所说的可查询到的信息。 举例:假设我们要查询获取accessToken接口的api调用额度。 我们cgi_path就要传/cgi-bin/token(这个参数不需要传域名,同时第一个/也不要遗漏了) 错误示例:如果我们cgi_path传的不对,那么接口就会返回76021,msg是cgi_path 出参包含:发送请求的耗时,时间戳,地址,请求参数,请求ip 通过这三个接口,我们就可以我们就可以做到查询接口调用次数,如果接口调用次数即将超过上限,我们就可以调用重置api,以防某些报错。

    1.2K10编辑于 2023-09-06
  • 来自专栏Rust语言学习交流

    【大家的项目】Poem-openapi

    注意:Poem-openapi只支持Poem,所以你如果希望使用它,Poem是必要的依赖,而且我不会考虑支持其它的web框架。 据我所知这是Rust语言里第一个用过程宏来实现OpenAPI规范的库,它的工作方式和Async-graphql非常的像,以类型安全的代码来编写符合OpenAPI规范的API并自动生成文档。 所有API宏描述的操作都会自动生成OpenAPI 3.0规范的文档,你可以clone仓库 https://github.com/poem-web/poem-openapi ,然后执行cargo run use std::collections::HashMap; use poem_openapi::{payload::Json, types::Password, OpenAPI, Response, https://github.com/poem-web/poem-openapi

    1.5K30发布于 2021-09-08
  • 来自专栏全栈测试开发日记

    Locust学习笔记6——参数

      引言   前面一篇文章cust学习笔记5——登录接口参数关联,简单介绍了关联的使用方法,我们不管做接口功能测试还是接口性能测试,都涉及关联、参数化和检查点。那么现在介绍一下参数化。    上面已经讲了背景,这里我要100个用户同时登录来测试系统的性能,相同的用户登录肯定不符合实际要求,此时我们可以考虑用参数化。    INFO/stdout: [2020-06-27 17:50:21,425] WIN10-804191526/INFO/stdout: visit url: url4   总结   自此,Locust参数化介绍完

    62140编辑于 2023-02-02
  • 来自专栏编程微刊

    ES6系列笔记-参数

    script> //2:展开一个数组,展开后的效果和把数组直接写出来是一样的 let arr1 = [1, 2, 3, 4]; let arr2 = [5, 6, 7] let arr = [...arr1, ...arr2]; // let arr=[1,2,3,4,5,6,7]; console.log(arr 3:参数的扩展和数组展开 <! 4:默认参数,传参就显示传的参数,不传参就显示默认的参数 <! ,传参就显示传的参数,不传参就显示默认的参数 function show(a, b = 4, c = 44) { console.log(a, b, c);

    36910发布于 2019-12-24
领券