Package google.golang.org/appengine/urlfetch (v1.6.8)

O pacote urlfetch fornece uma implementação http.RoundTripper para buscar URLs por meio do serviço urlfetch do App Engine.

Variáveis

ErrTruncatedBody

var ErrTruncatedBody = errors.New("urlfetch: truncated body")

ErrTruncatedBody é o erro retornado depois da Read() final do corpo de uma mensagem se o corpo foi truncado pelo proxy do App Engine.

Funções

func Client

func Client(ctx context.Context) *http.Client

Client retorna um *http.Client usando um Transport de urlfetch padrão. Ele vai verificar a validade dos certificados SSL.

Qualquer prazo do contexto fornecido será usado para solicitações feitas por esse cliente. Se o cliente não tiver um prazo, será usado o padrão de 60 segundos do App Engine.

Transporte

type Transport struct {
	Context context.Context

	// Controls whether the application checks the validity of SSL certificates
	// over HTTPS connections. A value of false (the default) instructs the
	// application to send a request to the server only if the certificate is
	// valid and signed by a trusted certificate authority (CA), and also
	// includes a hostname that matches the certificate. A value of true
	// instructs the application to perform no certificate validation.
	AllowInvalidServerCertificate bool
}

Transport é uma implementação de http.RoundTripper para o App Engine. Os usuários geralmente precisam criar um http.Client usando esse transporte e precisam usar o Client em vez de usar o transporte diretamente.

func (*Transport) RoundTrip

func (t *Transport) RoundTrip(req *http.Request) (res *http.Response, err error)

RoundTrip emite uma única solicitação HTTP e retorna a resposta dela. Pela interface http.RoundTripper, RoundTrip somente retorna um erro se havia uma solicitação incompatível ou se o proxy de Busca de URL falhar. Observe que códigos de resposta HTTP como 5xx, 403, 404 etc não são erros no que diz respeito ao transporte e são retornados com erro configurado como nil.