Recupero URL per servizi in bundle legacy

Questa pagina descrive 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 viene dedotta 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, si riferisce alla porta protocollo. Le richieste HTTP si verificano sulla porta 80 e si verificano le richieste HTTPS sulla porta 443.

Metodi di richiesta

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

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

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

Richiedi proxying

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 ricorrenza infinita di richieste, è necessario gestore di richieste non è autorizzato a recuperare il proprio URL. È ancora che sia possibile causare una ricorrenza infinita con altri mezzi, fai attenzione se è possibile indurre la tua applicazione a recuperare richieste per URL forniti dall'utente.

Intestazioni delle richieste

L'applicazione può impostare intestazioni HTTP per la richiesta in uscita.

Ad esempio, durante l'invio di una richiesta POST HTTP, se un'intestazione Content-Type viene non è impostata in modo esplicito, l'intestazione è impostata su x-www-form-urlencoded. Questo è il 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 su valori precisi da App Engine appropriato. Ad esempio, App Engine calcola Intestazione Content-Length dei dati della richiesta e la aggiunge a la richiesta prima dell'invio.

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

  • User-Agent. Questa intestazione può essere modificata, ma App Engine Aggiungere una stringa identificativo per consentire ai server di identificare l'App del motore di ricerca. 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 risulta aggiunta automaticamente se la richiesta viene inviata tramite il metodo di recupero URL .

Timeout delle richieste

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

Connessioni sicure e HTTPS

La tua applicazione può recuperare un URL in modo sicuro utilizzando HTTPS per la connessione a server protetti. I dati di richiesta e risposta vengono trasmessi in forma criptata.

Risposte

Se utilizzi l'API di recupero URL, tieni presente che il servizio di recupero URL restituisce dati della 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, il servizio seguirà il reindirizzamento. Il servizio seguite fino a cinque risposte di reindirizzamento, quindi restituiscono la risorsa finale.

Utilizzo del recupero URL sul server di sviluppo

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

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

Quote e limiti per il recupero degli URL

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

Vai alla pagina Dettagli quota

Inoltre, i seguenti limiti si applicano all'uso dei Servizio di recupero URL:

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