Condividi tramite


ApiCreateOrUpdateParameter interface

Creare o aggiornare i parametri dell'API.

Proprietà

apiRevision

Descrive la revisione dell'API. Se non viene specificato alcun valore, viene creata la revisione predefinita 1

apiRevisionDescription

Descrizione della revisione DELL'API.

apiType

Tipo di API.

apiVersion

Indica l'identificatore della versione dell'API se l'API è con versione

apiVersionDescription

Descrizione della versione dell'API.

apiVersionSet

Dettagli del set di versioni

apiVersionSetId

Identificatore di risorsa per l'Oggetto ApiVersionSet correlato.

authenticationSettings

Raccolta di impostazioni di autenticazione incluse in questa API.

contact

Informazioni di contatto per l'API.

description

Descrizione dell'API. Può includere tag di formattazione HTML.

displayName

Nome API. Deve contenere da 1 a 300 caratteri.

format

Formato del contenuto in cui viene importata l'API.

isCurrent

Indica se la revisione dell'API è la revisione api corrente.

isOnline

Indica se la revisione dell'API è accessibile tramite il gateway. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

license

Informazioni sulla licenza per l'API.

path

URL relativo che identifica in modo univoco questa API e tutti i relativi percorsi di risorse all'interno dell'istanza del servizio Gestione API. Viene aggiunto all'URL di base dell'endpoint API specificato durante la creazione dell'istanza del servizio per formare un URL pubblico per questa API.

protocols

Descrive i protocolli in cui è possibile richiamare le operazioni in questa API.

serviceUrl

URL assoluto del servizio back-end che implementa questa API. Non può contenere più di 2000 caratteri.

soapApiType

Tipo di API da creare.

  • http crea un'API REST
  • soap crea un'API pass-through SOAP
  • websocket crea l'API Websocket
  • graphql crea l'API GraphQL.
sourceApiId

Identificatore API dell'API di origine.

subscriptionKeyParameterNames

Protocolli su cui è disponibile l'API.

subscriptionRequired

Specifica se è necessaria una sottoscrizione api o prodotto per l'accesso all'API.

termsOfServiceUrl

URL delle condizioni di servizio per l'API. DEVE essere nel formato di un URL.

translateRequiredQueryParametersConduct

Strategia di conversione dei parametri di query necessari in quelli del modello. Per impostazione predefinita, il valore 'template'. Valori possibili: 'template', 'query'

value

Valore del contenuto durante l'importazione di un'API.

wsdlSelector

Criteri per limitare l'importazione di WSDL in un subset del documento.

Dettagli proprietà

apiRevision

Descrive la revisione dell'API. Se non viene specificato alcun valore, viene creata la revisione predefinita 1

apiRevision?: string

Valore della proprietà

string

apiRevisionDescription

Descrizione della revisione DELL'API.

apiRevisionDescription?: string

Valore della proprietà

string

apiType

Tipo di API.

apiType?: string

Valore della proprietà

string

apiVersion

Indica l'identificatore della versione dell'API se l'API è con versione

apiVersion?: string

Valore della proprietà

string

apiVersionDescription

Descrizione della versione dell'API.

apiVersionDescription?: string

Valore della proprietà

string

apiVersionSet

Dettagli del set di versioni

apiVersionSet?: ApiVersionSetContractDetails

Valore della proprietà

apiVersionSetId

Identificatore di risorsa per l'Oggetto ApiVersionSet correlato.

apiVersionSetId?: string

Valore della proprietà

string

authenticationSettings

Raccolta di impostazioni di autenticazione incluse in questa API.

authenticationSettings?: AuthenticationSettingsContract

Valore della proprietà

contact

Informazioni di contatto per l'API.

contact?: ApiContactInformation

Valore della proprietà

description

Descrizione dell'API. Può includere tag di formattazione HTML.

description?: string

Valore della proprietà

string

displayName

Nome API. Deve contenere da 1 a 300 caratteri.

displayName?: string

Valore della proprietà

string

format

Formato del contenuto in cui viene importata l'API.

format?: string

Valore della proprietà

string

isCurrent

Indica se la revisione dell'API è la revisione api corrente.

isCurrent?: boolean

Valore della proprietà

boolean

isOnline

Indica se la revisione dell'API è accessibile tramite il gateway. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

isOnline?: boolean

Valore della proprietà

boolean

license

Informazioni sulla licenza per l'API.

license?: ApiLicenseInformation

Valore della proprietà

path

URL relativo che identifica in modo univoco questa API e tutti i relativi percorsi di risorse all'interno dell'istanza del servizio Gestione API. Viene aggiunto all'URL di base dell'endpoint API specificato durante la creazione dell'istanza del servizio per formare un URL pubblico per questa API.

path?: string

Valore della proprietà

string

protocols

Descrive i protocolli in cui è possibile richiamare le operazioni in questa API.

protocols?: string[]

Valore della proprietà

string[]

serviceUrl

URL assoluto del servizio back-end che implementa questa API. Non può contenere più di 2000 caratteri.

serviceUrl?: string

Valore della proprietà

string

soapApiType

Tipo di API da creare.

  • http crea un'API REST
  • soap crea un'API pass-through SOAP
  • websocket crea l'API Websocket
  • graphql crea l'API GraphQL.
soapApiType?: string

Valore della proprietà

string

sourceApiId

Identificatore API dell'API di origine.

sourceApiId?: string

Valore della proprietà

string

subscriptionKeyParameterNames

Protocolli su cui è disponibile l'API.

subscriptionKeyParameterNames?: SubscriptionKeyParameterNamesContract

Valore della proprietà

subscriptionRequired

Specifica se è necessaria una sottoscrizione api o prodotto per l'accesso all'API.

subscriptionRequired?: boolean

Valore della proprietà

boolean

termsOfServiceUrl

URL delle condizioni di servizio per l'API. DEVE essere nel formato di un URL.

termsOfServiceUrl?: string

Valore della proprietà

string

translateRequiredQueryParametersConduct

Strategia di conversione dei parametri di query necessari in quelli del modello. Per impostazione predefinita, il valore 'template'. Valori possibili: 'template', 'query'

translateRequiredQueryParametersConduct?: string

Valore della proprietà

string

value

Valore del contenuto durante l'importazione di un'API.

value?: string

Valore della proprietà

string

wsdlSelector

Criteri per limitare l'importazione di WSDL in un subset del documento.

wsdlSelector?: ApiCreateOrUpdatePropertiesWsdlSelector

Valore della proprietà