Menerbitkan Permintaan HTTP(S)

ID region

REGION_ID adalah kode singkat yang ditetapkan Google berdasarkan region yang Anda pilih saat membuat aplikasi. Kode ini tidak sesuai dengan negara atau provinsi, meskipun beberapa ID region mungkin tampak mirip dengan kode negara dan provinsi yang umum digunakan. Untuk aplikasi yang dibuat setelah Februari 2020, REGION_ID.r disertakan dalam URL App Engine. Untuk aplikasi lama yang dibuat sebelum tanggal tersebut, ID region bersifat opsional dalam URL.

Pelajari ID region lebih lanjut.

Oke

Halaman ini menjelaskan cara menerbitkan permintaan HTTP(S) dari aplikasi App Engine Anda.

API ini didukung untuk runtime generasi pertama dan dapat digunakan saat mengupgrade ke runtime generasi kedua yang sesuai. Jika Anda mengupdate ke runtime App Engine Go 1.12+, lihat panduan migrasi guna mempelajari opsi migrasi Anda untuk layanan paket lama.

Untuk mengetahui detail tentang batas ukuran permintaan dan header mana yang dikirim dalam permintaan URL Fetch, lihat Permintaan Keluar.

Memberikan permintaan HTTP

Untuk mengeluarkan permintaan HTTP keluar, gunakan paket http seperti biasa, tetapi buat klien menggunakan urlfetch.Client. urlfetch.Client menampilkan *http.Client yang menggunakan urlfetch.Transport, yang merupakan implementasi antarmuka http.RoundTripper yang membuat permintaan menggunakan URL Fetch API.

Cuplikan berikut menunjukkan cara melakukan permintaan GET HTTP dasar:

import (
	"fmt"
	"net/http"

	"google.golang.org/appengine"
	"google.golang.org/appengine/urlfetch"
)

func handler(w http.ResponseWriter, r *http.Request) {
	ctx := appengine.NewContext(r)
	client := urlfetch.Client(ctx)
	resp, err := client.Get("https://www.google.com/")
	if err != nil {
		http.Error(w, err.Error(), http.StatusInternalServerError)
		return
	}
	fmt.Fprintf(w, "HTTP GET returned status %v", resp.Status)
}

Menonaktifkan pengalihan

Penting: Untuk meningkatkan keamanan aplikasi, sebaiknya nonaktifkan pengalihan.

Jika Anda menggunakan URL Fetch, layanan URL-Fetch dasar akan mengikuti hingga lima pengalihan secara default. Pengalihan ini dapat meneruskan informasi sensitif, seperti header otorisasi, ke tujuan yang dialihkan. Jika aplikasi Anda tidak memerlukan pengalihan HTTP, sebaiknya nonaktifkan pengalihan.

Untuk menginstruksikan layanan Fetch URL agar tidak mengikuti pengalihan, tetapkan kolom CheckRedirect dari http.Client yang ditampilkan dari urlfetch paket untuk menampilkan http.ErrUseLastResponse. Hal ini berlaku untuk appengine/urlfetch dan appengine/v2/urlfetch. Contoh:

client := urlfetch.Client(ctx)
client.CheckRedirect = func(*http.Request, []*http.Request) error {
  return http.ErrUseLastResponse
}

Memberikan permintaan HTTPS

Di Go API, Anda tidak perlu mengamankan permintaan secara eksplisit. Layanan Fetch URL yang mendasarinya memvalidasi sertifikat host yang dihubungi secara default, dan menolak permintaan jika sertifikat tidak cocok.

Menonaktifkan validasi sertifikat host

Untuk menonaktifkan validasi sertifikat host otomatis, Anda dapat membuat Transport secara manual dan menetapkan AllowInvalidServerCertificate ke true.

Mengeluarkan permintaan ke aplikasi App Engine lain

Saat menerbitkan permintaan ke aplikasi App Engine lain, aplikasi App Engine Anda harus menegaskan identitasnya dengan menambahkan header X-Appengine-Inbound-Appid ke permintaan tersebut. Jika Anda menginstruksikan layanan URL-Fetch untuk tidak mengikuti pengalihan, App Engine akan otomatis menambahkan header ini ke permintaan.

Lihat Menonaktifkan pengalihan untuk mendapatkan panduan tentang cara menonaktifkan pengalihan.

Catatan: Jika Anda membuat permintaan ke aplikasi App Engine lain, gunakan nama domain REGION_ID.r.appspot.com-nya, bukan domain kustom untuk aplikasi.

Langkah selanjutnya

Pelajari layanan URL-Fetch, seperti header yang dikirim dalam permintaan URL Fetch di Permintaan Keluar.