Updated on 2023-12-20 GMT+08:00

Restrictions and Compatibility

Note the following restrictions and compatibility issues when importing or exporting APIs on APIG:

Restrictions

  • APIG parameter restrictions:
    • APIG does not support the configuration of request parameters in the formData and body locations.
    • APIG does not support the configuration of parameters consumes and produces.
    • The names of header parameters are not case-sensitive.
  • Backend policy restrictions are as follows:
    • Default backend type HTTP: The HTTP and HTTP-VPC backends are supported.
    • Default backend type HTTP-VPC: The HTTP and HTTP-VPC backends are supported.
    • Default backend type function: Only the function backend is supported.
    • Default backend type mock: Only the mock backend is supported.

Compatibility

Table 1 Mappings between Swagger objects and APIG's objects

Swagger Object

APIG Object

Import

Export

info.title

API group name

Importing to a new API group: a new API group name

Importing to an existing API group: not used

An API group name consists of 3–64 characters, starting with a letter. Only letters, digits, and underscores (_) are allowed.

API group name

info.description

API group description

Importing to a new API group: description about the new group

Importing to an existing API group: not used

API group description

info.version

Version

Not used

User-defined version

The current time is used as the API group name if no name is specified.

host

API group domain name

Not used

The first user-defined domain name of an API group is preferentially used.

The independent domain name of the API group is used if the API group is not bound with any user-defined domain names.

basePath

-

Merged with the request path of each API

Not used

paths.path

API request path

Merged with basePath to use as an API request path

API request path

operation.operationId

API name

API name

API name

operation.description

API description

API description

API description

operation.parameters

API frontend request parameters

API request parameters

API request parameters

operation.schemes

API frontend request protocol

API request protocol

API request protocol

operation.responses

-

Not used

Default response

operation.security

API authentication mode

API authentication mode

Used together with x-apigateway-auth-type

API authentication mode

Used together with x-apigateway-auth-type

Table 2 Differences in request parameter types

Swagger

APIG

Supported Attribute

integer

long

float

double

number

maximum

minimum

default

enum

required

description

string

string

maxLength

minLength

default

enum

required

description

Other

None

None

Table 3 Differences in API request path template syntax

Syntax

Swagger

APIG

/users/{userName}

Supported

Supported

/users/prefix-{userName}

/users/{userName}-suffix

/users/prefix-{userName} -suffix

Supported

Not supported for frontend request definition

Supported for backend request definition

/users/{proxy+}

Not supported

Supported for frontend request definition

Not supported for backend request definition