我有一个基本路径URL,并且所有API都在此列表下列出,API具有不同的查询参数。为了解决此问题,我为每个API使用了片段标识符
openapi: 3.0.0
info:
title: API Documentation
description: This documentation gives you real time experience
servers:
- url: https://secure.server.in/merchant
description: Optional server description, e.g. Main (production) server
- url: https://test.server.in/merchant
description: Optional server description, e.g. Internal staging server for testing
paths:
/postservice#api_to_vefiry:
Swagger用户界面没有给我任何错误,我也收到了API响应。
但是响应不正确,因为片段标识符附加在请求URL和cURL请求上。
https://test.server.in/merchant/postservice#api_to_vefiry?form=2
这是形成的cURL请求:
curl -X POST "https://test.server.in/merchant/postservice#api_to_vefiry?form=2" -H "accept: application/json" -H "Content-Type: application/x-www-form-urlencoded" -d "key=gtKFFx&command=verify_payment&var1=20190729&hash=063457c2c37daed990c8a6aee86a993df72dcd48ddef8fa384e587222a12529a2549d74b3713cb721d49170d5ac73e8835c0b2ca08a39323af8747becb8368bf"
现在,通过在路径中添加片段标识符,我可以记录不同的API,但是同时,它附加到请求URL上,从而给出不需要的响应。
有什么方法可以防止Swagger UI将片段标识符添加到请求URL?
或者还有其他方法可以用同一URL定义多个API操作吗?请注意,每个操作都有其自己不同的查询参数。