ID da região
O REGION_ID é um código abreviado que a Google atribui com base na região que seleciona quando cria a sua app. O código não corresponde a um país ou uma província, embora alguns IDs de regiões possam parecer semelhantes aos códigos de países e províncias usados com frequência. Para apps criadas após
fevereiro de 2020, REGION_ID.r está incluído nos
URLs do App Engine. Para apps existentes criadas antes desta data, o
ID da região é opcional no URL.
Saiba mais acerca dos IDs de regiões.
Esta página descreve como emitir pedidos HTTP(S) a partir da sua app do App Engine usando o serviço URL Fetch para runtimes de segunda geração.
Antes de seguir as instruções nesta página, recomendamos que use soluções idiomáticas para emitir pedidos HTTP(S) antes de usar o serviço URL Fetch. O principal exemplo de utilização da obtenção de URLs é quando quer emitir pedidos HTTP(S) para outra app do App Engine e afirmar a identidade da sua app nesse pedido.
Para ver detalhes sobre os limites de tamanho dos pedidos e os cabeçalhos enviados num pedido de obtenção de URL, consulte o artigo Pedidos de saída.
Emitir um pedido HTTP
Para usar o serviço de obtenção de URL para emitir pedidos HTTP(S) de saída, declare as bibliotecas de obtenção de URL.
A linguagem PHP oferece várias funções para fazer pedidos HTTP remotos. Estas são implementadas de diferentes formas no App Engine e estão sujeitas a diferentes quotas e custos.
Consulte o guia de acesso a serviços agrupados antigos para PHP para ver instruções sobre como usar controladores de streams.
Defina um limite de tempo do pedido
Use a opção timeout em Contexto HTTP para alterar o prazo.
Desative os redirecionamentos
Se estiver a usar a obtenção de URLs, o serviço de obtenção de URLs subjacente segue até cinco redirecionamentos por predefinição. Estes redirecionamentos podem encaminhar informações confidenciais, como cabeçalhos de autorização, para o destino redirecionado. Se a sua app não requerer redirecionamentos HTTP, recomendamos que os desative.
Para indicar ao serviço URL Fetch que não siga os redirecionamentos, a sua app tem de
definir o parâmetro follow_location nas
opções de contexto HTTP
para false.
Emitir um pedido HTTPS
Por predefinição, o serviço URL Fetch subjacente valida o certificado do anfitrião que contacta e rejeita pedidos se o certificado não corresponder. Não precisa de proteger explicitamente o seu pedido.
Desative a validação de certificados de anfitrião
Por predefinição, a implementação do App Engine do wrapper HTTPS tenta validar o certificado do anfitrião e rejeita pedidos em que o certificado não corresponde. Para desativar este comportamento, defina o valor de
verify_peer como false nas
opções de contexto SSL/TLS.
Emitir um pedido para outra app do App Engine
Quando usa a obtenção de URLs para emitir um pedido a outra app do App Engine, a sua app pode afirmar a respetiva identidade adicionando o cabeçalho X-Appengine-Inbound-Appid ao pedido.
Se instruir o serviço URL Fetch para não seguir redirecionamentos, o App Engine adiciona este cabeçalho aos pedidos automaticamente. Consulte o artigo Desativar redirecionamentos para obter orientações sobre como desativar redirecionamentos.
O que se segue?
Saiba mais sobre o serviço de obtenção de URL, como os cabeçalhos que são enviados num pedido de obtenção de URL em Pedidos de saída.