如何在无OpenAPI定义的情况下手动将API导入WSO2 API Manager？

一、手动创建WSO2 API（无需OpenAPI定义） #

按以下标准流程配置，确保每个环节正确：

• 登录WSO2 API Manager控制台，进入API Publisher模块
• 点击Create API，选择Blank API选项
• 填写API基础信息：名称、版本、上下文（比如/my-target-api），完成后点击Next
• 切换到Resources标签页，点击Add Resource：
  • 选择与目标API匹配的HTTP方法（GET/POST/PUT等）
  • 填写资源路径（比如/user/list，需和目标API的实际路径完全对应）
  • 可补充简要描述，方便后续管理
• 进入Endpoints标签页，点击Add Endpoint：
  • 选择HTTP/REST Endpoint类型
  • 填写目标API的完整基础地址（比如https://your-api-domain.com/service），注意包含正确的协议（http/https）
  • 若目标API需要认证，在Endpoint Auth中配置对应凭证（如Basic Auth、OAuth2令牌）
• 切换到Security标签页，添加所需安全策略（如API Key、OAuth2），匹配客户端的认证需求
• 点击Save保存配置，再点击Publish将API发布到网关
• 进入API Developer Portal，订阅该API并获取调用凭证（如API Key），进行测试调用

二、快速生成极简OpenAPI定义（可选） #

如果更倾向用导入方式创建API，可手动编写极简版OpenAPI文件，无需完整的请求/响应Schema：

openapi: 3.0.3
info:
  title: 目标API简易定义
  version: 1.0.0
servers:
  - url: https://your-target-api-domain.com/service  # 替换为你的目标API基础地址
paths:
  /user/list:  # 替换为目标API的实际路径
    get:
      responses:
        '200':
          description: 成功响应
  /user/create:
    post:
      responses:
        '201':
          description: 创建成功

将上述内容保存为openapi.yaml，在WSO2中选择Import API > OpenAPI，上传该文件即可完成导入。

三、排查手动创建失败的常见问题 #

如果之前手动配置后无法正常工作，优先检查以下几点：

• 后端端点连通性：在WSO2服务器所在环境，用curl命令测试目标API是否可达，排除网络防火墙、DNS解析等问题
• 资源路径匹配：WSO2的API上下文 + 资源路径需与目标API的完整路径对应。比如目标API地址是https://xxx.com/service/user/list，WSO2上下文设为/my-api，则资源路径需设为/user/list，客户端调用地址为https://wso2-gateway-domain/my-api/user/list
• 认证转发配置：若目标API需要认证，需在WSO2的Endpoint Auth中配置对应凭证，或通过消息中介策略将客户端的认证令牌转发至后端
• 网关同步状态：发布API后，在API Publisher > Gateway Status中检查网关是否同步成功，未同步需手动触发刷新

内容的提问来源于stack exchange，提问作者developerkele