Emitir solicitações HTTPS

ID da região

O REGION_ID é um código abreviado que o Google atribui com base na região que você selecionou ao criar o aplicativo. O código não corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes aos códigos de país e estado geralmente usados. Para apps criados após fevereiro de 2020, o REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criados antes dessa data, o ID da região é opcional no URL.

Saiba mais sobre IDs de região.

Nesta página, descrevemos como emitir solicitações HTTP(S) do aplicativo do App Engine usando o serviço de busca de URL para ambientes de execução de segunda geração.

Antes de seguir as instruções nesta página, recomendamos que você use soluções idiomáticas de linguagem para emitir solicitações HTTP(S) antes de usar o serviço de busca de URL. O principal caso de uso para utilizar a busca de URL é quando você quer emitir solicitações HTTP(S) para outro aplicativo do App Engine e declarar a identidade do aplicativo nessa solicitação.

Para mais detalhes sobre os limites de tamanho de solicitação e quais cabeçalhos são enviados em uma solicitação de busca de URL, consulte Solicitações de saída.

Emitir uma solicitação HTTP

Para usar o serviço de busca de URL para emitir solicitações HTTP(S) de saída, declare as bibliotecas de busca de URL.

A linguagem PHP oferece várias funções para fazer solicitações HTTP remotas. Elas são implementadas de diferentes maneiras no Google App Engine e estão sujeitas a várias cotas e custos:

Consulte o guia Acessar serviços integrados legados para PHP para mais instruções sobre como usar gerenciadores de stream.

Definir um tempo limite de solicitação

Use a opção timeout em Contexto HTTP para alterar o prazo.

Desativar redirecionamentos

Se você estiver usando a busca de URL, o serviço subjacente de busca de URL seguirá até cinco redirecionamentos por padrão. Esses redirecionamentos podem encaminhar informações confidenciais, como cabeçalhos de autorização, para o destino redirecionado. Se o aplicativo não exigir redirecionamentos HTTP, é recomendável que você os desative.

Para instruir o serviço de busca de URL a não seguir redirecionamentos, seu aplicativo precisa definir o parâmetro follow_location nas Opções de contexto HTTP para false.

Emitir uma solicitação HTTPS

Por padrão, o serviço de busca de URL subjacente valida o certificado do host que ele acessa e rejeita solicitações se o certificado não corresponder. Não é necessário proteger explicitamente sua solicitação.

Desativar a validação do certificado do host

Por padrão, a implementação do wrapper HTTPS do App Engine tenta validar o certificado do host e rejeita as solicitações em que o certificado não corresponde. Para desativar esse comportamento, defina o valor de verify_peer como false nas opções de contexto SSL/TLS.

Emitir uma solicitação para outro app do App Engine

Ao usar a busca de URL para emitir uma solicitação a outro aplicativo do App Engine, seu aplicativo pode declarar a identidade dele adicionando o cabeçalho X-Appengine-Inbound-Appid à solicitação.

Se você instruir o serviço de busca de URL a não seguir redirecionamentos, o App Engine adicionará esse cabeçalho às solicitações automaticamente. Consulte Como desativar redirecionamentos para orientação sobre como desativar redirecionamentos.

A seguir

Para saber mais sobre o serviço de busca de URL, como os cabeçalhos que são enviados em uma solicitação de busca de URL, consulte Solicitações de saída.