Recupero URL per servizi in bundle legacy

In questa pagina viene descritto come inviare richieste HTTP e HTTPS e ricevere risposte utilizzando il servizio di recupero URL.

Richieste

Protocolli di richiesta

Un'applicazione può recuperare un URL tramite HTTP o HTTPS. Il protocollo da utilizzare viene dedotto osservando il protocollo nell'URL di destinazione.

L'URL da recuperare può utilizzare qualsiasi numero di porta nei seguenti intervalli:

  • 80-90
  • 440-450
  • 1024-65535

Se la porta non è menzionata nell'URL, è implicita dal protocollo. Le richieste HTTP si verificano sulla porta 80, mentre le richieste HTTPS si verificano sulla porta 443.

Metodi di richiesta

Se invii le richieste tramite il servizio di recupero URL, puoi utilizzare uno dei seguenti metodi HTTP:

  • GET
  • POST
  • PUT
  • HEAD
  • DELETE
  • PATCH

Una richiesta può includere intestazioni HTTP e, per le richieste POST, PUT e PATCH, un payload.

Richiedi proxy

Tieni presente che il servizio di recupero URL utilizza un proxy compatibile con HTTP/1.1 per recuperare il risultato.

Per evitare che un'applicazione causi una ricorsione infinita di richieste, un gestore delle richieste non può recuperare il proprio URL. È ancora possibile causare una ricorsione infinita con altri mezzi, quindi presta attenzione se la tua applicazione può essere utilizzata per recuperare richieste per gli URL forniti dall'utente.

Intestazioni delle richieste

La tua applicazione può impostare intestazioni HTTP per la richiesta in uscita.

Ad esempio, quando invii una richiesta POST HTTP, se un'intestazione Content-Type non viene impostata esplicitamente, l'intestazione viene impostata su x-www-form-urlencoded. Si tratta del tipo di contenuti utilizzato dai moduli web.

Per motivi di sicurezza, le seguenti intestazioni non possono essere modificate dall'applicazione:

  • Content-Length
  • Host
  • Vary
  • Via
  • X-Appengine-Inbound-Appid
  • X-Forwarded-For
  • X-ProxyUser-IP

Queste intestazioni sono impostate da App Engine su valori accurati, a seconda dei casi. Ad esempio, App Engine calcola l'intestazione Content-Length a partire dai dati della richiesta e la aggiunge alla richiesta prima dell'invio.

Le seguenti intestazioni indicano l'ID applicazione dell'app richiedente:

  • User-Agent. Questa intestazione può essere modificata, ma App Engine aggiungerà una stringa identificatore per consentire ai server di identificare le richieste App Engine. La stringa aggiunta ha il formato "AppEngine-Google; (+http://code.google.com/appengine; appid: APPID)", dove APPID è l'identificatore dell'app.
  • X-Appengine-Inbound-Appid. Questa intestazione non può essere modificata e viene aggiunta automaticamente se la richiesta viene inviata tramite il servizio di recupero URL.

Timeout delle richieste

Puoi impostare una scadenza o un timeout per una richiesta. Per impostazione predefinita, il timeout di una richiesta è di 10 secondi.

Connessioni sicure e HTTPS

La tua applicazione può recuperare un URL in modo sicuro utilizzando HTTPS per connettersi a server sicuri. I dati di richieste e risposte vengono trasmessi sulla rete in formato criptato.

Risposte

Se utilizzi l'API URL Fetch, tieni presente che il servizio di recupero URL restituisce tutti i dati di risposta, tra cui risposta, codice, intestazioni e corpo.

Per impostazione predefinita, se il servizio di recupero URL riceve una risposta con un codice di reindirizzamento, seguirà il reindirizzamento. Il servizio seguirà fino a cinque risposte di reindirizzamento, quindi restituirà la risorsa finale.

Utilizzo dello strumento Recupero URL sul server di sviluppo

Quando l'applicazione è in esecuzione sul server di sviluppo App Engine sul tuo computer, le chiamate al servizio di recupero URL vengono gestite localmente. Il server di sviluppo recupera gli URL contattando gli host remoti direttamente dal computer, utilizzando qualsiasi configurazione di rete utilizzata dal computer per accedere a internet.

Quando testi le funzionalità della tua applicazione che recuperano gli URL, assicurati che il tuo computer possa accedere agli host remoti.

Quote e limiti per il recupero di URL

Per informazioni sulle quote di servizio di recupero URL, consulta Quote. Per visualizzare l'utilizzo attuale della quota per la tua applicazione, vai alla pagina Dettagli quota nella console Google Cloud.

Vai alla pagina Dettagli quota

Inoltre, all'utilizzo del servizio Recupero URL si applicano i seguenti limiti:

Limit Amount
Request size 10 megabytes
Request header size 16 KB (Note that this limits the maximum length of the URL that can be specified in the header)
Response size 32 megabytes
Maximum deadline (request handler) 60 seconds
Maximum deadline (Task Queue and cron job handler) 60 seconds