接口导入导出

接口导入

Torna接口导入有以下几种形式：

• 手动创建接口
• 导入swagger json/yaml
• 导入swagger url
• 通过OpenAPI 导入swagger json/yaml

手动创建接口

入口：

手动创建文档提供三种形式

• 标准文档：创建标准API文档，具备URL/METHOD/请求参数/响应参数
• 富文本文档：编写富文本内容
• Markdown：编写Markdown内容

导入swagger json/yaml

入口：

选择三种导入方式

通过OpenAPI 导入swagger json/yaml

使用OpenAPI进行推送

请求body：

{
  "name": "swagger-json.push",
  "version": "1.0",
  "data": {
    "author": "jim",
    "json": "json 或 yaml 内容"
  },
  "access_token": "3a6f9fd55e7547a78493e1082ecc1782"
}

• 请求示例

import com.alibaba.fastjson.JSON;
import junit.framework.TestCase;
import org.junit.jupiter.api.Test;

import java.io.IOException;
import java.net.URLEncoder;
import java.util.HashMap;
import java.util.Map;

public class PostTest extends TestCase {

  static String url = "http://localhost:7700/api";
  static String token = "e807db2eb8564c4b89caf5a2f2d15b77";

  @Test
  public void testPost() throws IOException {
    // 业务参数
    Map<String, Object> bizParams = new HashMap<String, Object>();
    bizParams.put("author", "jim");
    bizParams.put("json", " json 或 yaml内容");

    String json = JSON.toJSONString(bizParams);
    json = URLEncoder.encode(json, "utf-8");

    // 公共参数
    Map<String, Object> param = new HashMap<String, Object>();
    // 设置接口名
    param.put("name", "swagger-json.push");
    // 设置业务参数
    param.put("data", json);
    // 设置版本号
    param.put("version", "1.0");
    // 设置token
    param.put("access_token", token);

    System.out.println("=====请求数据=====");
    String postJson = JSON.toJSONString(param);
    System.out.println(postJson);
    // 发送请求
    String resp = HttpUtil.postJson(url, postJson);
  }

}

接口导出

接口导出可以分为以下几种：

• 自定义导出，支持导出（markdown/word/html）
• 导出postman格式
• 复制postman url
• 导出openapi3 json
• 复制openapi3 url

自定义导出

入口：

设置导出形式

其它形式导出

点击下拉箭头查看更多：