dry Run Api OAS

POST {{baseUrl}}/api/apis/oas/dry-run?upstreamURL=<string>&listenPath=<string>&customDomain=<string>&allowList=true&validateRequest=true&mockResponse=true&authentication=true&templateID=<string>

Generate a Tyk OAS API definition without saving it to the Dashboard database. This endpoint is used to produce a Tyk OAS API definition without creating the API proxy itself. This provides a dry run functionality for Tyk OAS API creation, showing what would be created in the Dashboard given the set of inputs provided.

Request Params

KeyDatatypeRequiredDescription
upstreamURLstringUpstream URL for the API
listenPathstringListen path for the API
customDomainstringCustom domain for the API
allowListbooleanEnable allowList middleware for all endpoints
validateRequestbooleanEnable validateRequest middleware for all endpoints having a request body with media type application/json
mockResponsebooleanEnable mockResponse middleware for all endpoints having responses configured.
authenticationbooleanEnable/disable the authentication mechanism in your Tyk Gateway for your OAS API
templateIDstringThe asset ID of template to apply while importing an OAS API.

Request Body

{"oas"=>{"value"=>"reference https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.0/schema.json not found in the OpenAPI spec"}, "tyk_oas"=>{"x-tyk-api-gateway"=>{"info"=>{"id"=>"<string>", "dbId"=>"<string>", "orgId"=>"<string>", "name"=>"<string>", "state"=>{"active"=>"<boolean>"}}, "upstream"=>{"url"=>"<string>"}, "server"=>{"listenPath"=>{"value"=>"<string>", "strip"=>"<boolean>"}}}}}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;x-tyk-api-gateway&quot;:{&quot;info&quot;:{&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;dbId&quot;:&quot;\u003cstring\u003e&quot;,&quot;orgId&quot;:&quot;\u003cstring\u003e&quot;,&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;state&quot;:{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;}},&quot;upstream&quot;:{&quot;url&quot;:&quot;\u003cstring\u003e&quot;},&quot;server&quot;:{&quot;listenPath&quot;:{&quot;value&quot;:&quot;\u003cstring\u003e&quot;,&quot;strip&quot;:&quot;\u003cboolean\u003e&quot;}}}}