Halaman ini diterjemahkan oleh Cloud Translation API.

Mulai menggunakan Apigee API

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Apigee API dapat digunakan untuk mengembangkan dan mengelola API secara terprogram dengan serangkaian operasi RESTful.

Anda dapat menggunakan Apigee API untuk mengintegrasikan pengelolaan proxy API ke dalam software development lifecycle (SDLC) organisasi Anda. Umumnya, Apigee API digunakan untuk menulis skrip atau kode yang men-deploy proxy API atau yang memigrasikan proxy API dari satu lingkungan ke lingkungan lainnya, sebagai bagian dari proses otomatis yang lebih besar, yang juga men-deploy atau memigrasikan aplikasi lain.

Untuk mengetahui informasi selengkapnya, lihat Apigee API.

Mengaktifkan Apigee API

Pastikan Anda telah mengaktifkan Apigee API. Cara termudah untuk mengaktifkan API untuk project Anda adalah dengan menggunakan Konsol Google Cloud. Untuk mengetahui detail selengkapnya, lihat Langkah 3: Aktifkan API.

Mendapatkan token akses OAuth 2.0

Apigee API mendukung OAuth 2.0 untuk autentikasi pengguna. Dengan OAuth 2.0, Anda menukar kredensial Google Cloud dengan token akses yang kemudian dapat digunakan untuk melakukan panggilan yang aman ke Apigee API. Setelah mendapatkan token, Anda tidak perlu bertukar kredensial lagi sampai masa berlaku token habis.

Mendapatkan token menggunakan kredensial Google Cloud

Untuk mendapatkan token menggunakan kredensial Google Cloud Anda:

Izinkan gcloud mengakses Cloud Platform dengan kredensial pengguna Google Anda:
```
gcloud auth login
```
Mendapatkan token untuk akun yang saat ini aktif:
```
export TOKEN=$(gcloud auth print-access-token)
```
Saat Anda memanggil Apigee API, teruskan token akses di header Authorization. Contoh:
```
curl "https://apigee.googleapis.com/v1/organizations" -H "Authorization: Bearer $TOKEN"
```

Mendapatkan token menggunakan kunci akun layanan Google Cloud

Untuk mendapatkan token menggunakan kunci akun layanan untuk otorisasi:

Buat kunci untuk akun layanan Anda menggunakan GCP Console, seperti yang dijelaskan dalam Membuat dan mengelola kunci akun layanan.
File JSON yang berisi kredensial akun layanan Anda akan didownload ke komputer Anda.
Tetapkan variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS ke jalur tempat kunci akun layanan berada:
```
export GOOGLE_APPLICATION_CREDENTIALS=your_sa_credentials_file.json
```

Saat Anda memanggil Apigee API, gunakan Google Cloud CLI untuk menambahkan token akses ke header Otorisasi. Contoh:

curl "https://apigee.googleapis.com/v1/organizations" -H "Authorization: Bearer $(gcloud auth application-default print-access-token)"

Menyetel variabel lingkungan untuk permintaan Apigee API

Contoh Apigee API dan gcloud CLI yang disediakan di seluruh dokumentasi menggunakan satu atau beberapa variabel lingkungan yang ditentukan dalam tabel berikut.

Dengan menetapkan variabel lingkungan di awal ke nilai yang bermakna di lingkungan, Anda dapat menyalin dan menempelkan contoh permintaan untuk menjalankannya di lingkungan Anda sendiri dengan sedikit atau tanpa perubahan.

Variabel lingkungan	Deskripsi
`$API`	Nama proxy API Anda.
`$APIPRODUCT`	Nama produk API.
`$APP`	ID aplikasi.
`$DEVELOPER_EMAIL`	Alamat email developer.
`$ENV`	Nama lingkungan Anda, seperti `test` atau `prod`.
`$ID`	ID resource.
`$KEY`	Kunci konsumen.
`$NAME`	Nama resource Anda.
`$ORG`	Organisasi Apigee Anda.
`$REV`	Nomor revisi proxy API Anda.
`$SHAREDFLOW`	Nama alur yang dibagikan.
`$TYPE`	Jenis resource.

Menggunakan curl

Contoh di bagian ini menggunakan curl untuk menunjukkan cara mengembangkan aplikasi menggunakan Apigee API. curl adalah alat command line open source untuk mentransfer data dengan sintaksis URL, yang mendukung protokol umum seperti HTTP dan HTTPS.

Tabel berikut merangkum opsi command line curl yang digunakan dalam contoh.

Opsi	Deskripsi
`-d '{}' --data @filename --data-binary @filename`	Menentukan isi permintaan, yang dapat Anda teruskan secara langsung atau dengan menentukan nama file.
`-F file=@filename --form file=@filename`	Mendefinisikan data berbasis formulir yang dapat Anda teruskan dengan menentukan nama file.
`-H --header`	Mendefinisikan header permintaan. Anda harus meneruskan informasi berikut di header permintaan: Header `Authorization`: Token OAuth 2.0 untuk autentikasi pengguna, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0. Header `Content-Type`: Jenis konten isi permintaan yang dikirim saat membuat atau memperbarui resource (POST, PATCH, PUT) menggunakan API.
`-X`	Menentukan jenis permintaan (GET, POST, dan sebagainya).

Contoh:

curl "https://apigee.googleapis.com/v1/organizations/$ORG/apis" \
   -X GET \
   -H "Authorization: Bearer $TOKEN"

Dengan $TOKEN ditetapkan ke token akses OAuth 2.0, seperti yang dijelaskan dalam Mendapatkan token akses OAuth 2.0.