Questa pagina è stata tradotta dall'API Cloud Translation.

Deployment e test di un'API

Questa pagina descrive come eseguire il deployment dell'API.

Prima di iniziare

Configura l'ambiente di programmazione.
Crea un'API e annotala.

Distribuzione di un'API

Puoi eseguire il deployment dell'API utilizzando i plug-in Apache Maven o Gradle per App Engine. Per eseguire il deployment della tua API in un ambiente standard di App Engine di produzione, utilizza il comando per il tuo plug-in:

Utilizza il comando per il tuo plug-in:
Maven
```
mvn appengine:deploy
```
Gradle
```
gradle appengineDeploy
```
Attendi il completamento del deployment.

Invia una richiesta di test all'API di cui è stato eseguito il deployment. Ad esempio, utilizzando curl:

curl \
    -H "Content-Type: application/json" \
    -X POST \
    -d '{"message": "echo"}' \
    "https://YOUR-PROJECT-ID.appspot.com/_ah/api/echo/v1/echo?n=2"

La tua risposta è simile alla seguente:

{
  "message": "echo echo"
}

Se non hai ricevuto una risposta positiva, consulta la sezione Risoluzione dei problemi relativi alle risposte.

Deployment in più versioni dell'applicazione

Per informazioni su come eseguire il controllo delle versioni dell'API e su come eseguire il deployment nelle versioni, consulta Gestione del controllo delle versioni dell'API

Eseguire e testare i backend dell'API in locale

Per testare l'API localmente:

Compila il progetto nella directory principale del progetto. Ad esempio:
Maven
```
mvn clean package
```
Gradle
```
gradle clean build
```
Avvia il server di sviluppo App Engine. Ad esempio:
Maven
```
mvn appengine:run
```
Gradle
```
gradle appengineRun
```

Fai una richiesta API per testare l'API. Ad esempio, utilizzando curl:

curl \
    -H "Content-Type: application/json" \
    -X POST \
    -d '{"message": "echo"}' \
    "${HOST}/_ah/api/echo/v1/echo?n=2"

Pubblicazione dell'API da un percorso diverso

Per pubblicare l'API da un percorso diverso, nel file web.xml modifica url-pattern nella sezione EndpointsServlet e reimplementa l'API. Ad esempio:

<servlet-mapping>
    <servlet-name>EndpointsServlet</servlet-name>
    <url-pattern>/example-api/*</url-pattern>
</servlet-mapping>

Aggiunta della gestione delle API

Endpoints Frameworks fornisce funzionalità di gestione delle API come:

Affinché la tua API venga gestita dai framework Endpoints, devi generare e implementare un documento OpenAPI che la descriva, come descritto in Aggiunta della gestione delle API.