API Gateway:Mengakses layanan backend HTTP menggunakan API Gateway

1. Buat layanan backend: Pada langkah ini, Anda mengonfigurasi layanan backend sebagai resource di wilayah tempat instance API Gateway Anda berada. Layanan backend yang telah dikonfigurasi dapat langsung dipilih saat membuat API.

2. Buat grup API: Pada langkah ini, Anda membuat grup API. API dikelola dalam grup berdasarkan jenis bisnis dan struktur organisasi.

3. Buat API: Pada langkah ini, Anda membuat API di Konsol API Gateway.

4. Buat aplikasi dan otorisasi untuk memanggil API: Pada langkah ini, Anda membuat aplikasi dan memberikan otorisasi agar aplikasi tersebut dapat memanggil API sebagai identitas pemanggil.

5. Debug API: Pada langkah ini, Anda memverifikasi apakah API berfungsi sesuai harapan dengan menggunakan fitur debugging online yang disediakan oleh Konsol API Gateway.

6. Panggil API: Pada langkah ini, Anda dapat menggunakan SDK yang disediakan oleh API Gateway atau menjalankan perintah cURL di tool command-line untuk memanggil API.

1. Masuk ke Konsol API Gateway. Di bilah navigasi atas, pilih wilayah. Di panel navigasi kiri, pilih Manage APIs > Backend Services. Lalu, klik Create Backend Service di pojok kanan atas.

2. Pada dialog Create Backend Service, atur Name menjadi httpd-online dan Type menjadi HTTP/HTTPS Service, lalu klik Confirm.

3. Di halaman Backend Services, klik layanan backend httpd-online. Di halaman Backend Service Definition, klik tab Production, lalu klik Create di pojok kanan atas.

4. Di halaman Basic Information, masukkan http://192.168.*.***:80 di kotak Backend Service URL, lalu klik Publish.

   Catatan

   http://192.168.*.***:80 adalah Alamat IP pribadi dari instance ECS yang telah dibuat.

1. Di panel navigasi kiri, pilih Manage APIs > API Groups. Di halaman API Groups, klik Create Group di pojok kanan atas.

2. Pada dialog Create Group, pilih instance dari daftar drop-down Instances, atur Group Name menjadi httpd-demo, atur BasePath menjadi /, lalu klik Confirm.

Buat aplikasi

1. Di panel navigasi kiri, pilih Call APIs > Apps. Di halaman Apps, klik Create App di pojok kanan atas.

2. Masukkan nama aplikasi di bidang App Name dan klik Confirm. Dalam contoh ini, nama aplikasi yang dimasukkan adalah httpd.

3. Di halaman Apps, klik aplikasi httpd yang telah Anda buat. Di halaman App Details, Anda dapat melihat dua metode autentikasi yang tersedia: AppKey dan AppCode. Metode AppKey mencakup sepasang AppKey dan AppSecret, yang bekerja mirip seperti pasangan username dan password. Saat memanggil API, Anda harus mengirimkan AppKey sebagai parameter, sedangkan AppSecret digunakan untuk menghitung signature. API Gateway memverifikasi pasangan AppKey-AppSecret untuk mengotentikasi identitas Anda.

Otorisasi aplikasi untuk memanggil API

1. Di panel navigasi kiri, pilih Manage APIs > APIs. Di halaman APIs, temukan API http-test dan klik > Authorize di kolom Actions.

2. Di halaman Authorize, atur parameter Stage menjadi Production. Masukkan nama aplikasi yang telah Anda buat di bilah pencarian bagian Choose Apps for Authorization. Di hasil pencarian, pilih aplikasi yang telah dibuat, klik Add di kolom Actions, lalu klik Confirm. Pesan akan muncul untuk memberi tahu bahwa aplikasi telah diotorisasi untuk memanggil API.

Gunakan SDK

1. Di panel navigasi kiri, pilih Call APIs > SDK. Di bagian Sample Code for Node.js Signature in Other Languages, pilih bahasa, misalnya Node.js, lalu klik View Sample Code for Node.js.

2. Jalankan perintah $ npm install aliyun-api-gateway -S untuk menggunakan npm menginstal SDK contoh untuk Node.js.

   Dalam potongan kode berikut, atur YOUR_APP_KEY dan YOUR_APP_SECRET menjadi AppKey dan AppSecret dari aplikasi yang dibuat dalam contoh ini.

   // Impor SDK untuk Node.js yang telah Anda unduh.
   const Client = require('aliyun-api-gateway').Client;
   // Buat instans untuk aplikasi yang telah diotorisasi. Tentukan AppKey dan AppSecret dari aplikasi yang diotorisasi.
   const client = new Client('YOUR_APP_KEY','YOUR_APP_SECRET');
   async function get() {
   // Gunakan nama domain grup API tempat API yang ingin Anda panggil berada. Anda dapat menggunakan public second-level domain name yang disediakan oleh API Gateway untuk menguji pemanggilan API. Namun, jumlah pemanggilan API dibatasi. Kami menyarankan agar Anda mengikat independent domain name ke Grup API tersebut.
     var url = 'YOUR_GROUP_DOMAIN';
     var result = await client.get(url, {
   // Tentukan header permintaan. Beberapa API dapat mengembalikan format data berdasarkan tipe respons yang ditentukan. Kami menyarankan agar Anda menentukan header permintaan secara manual sesuai kebutuhan bisnis Anda. 
       headers: {
         accept: 'application/json'
       },
     });
     console.log(JSON.stringify(result));
   }
   get().catch((err) => {
     console.log(err.stack);
   });                

Gunakan cURL

Di panel navigasi kiri, pilih Call APIs > Apps. Di halaman Apps, klik aplikasi yang telah diotorisasi dan dapatkan AppCode-nya di halaman yang muncul. Lalu, gunakan contoh kode berikut untuk memanggil API:

curl -i -X GET "http://3fbf0648d01e4aa5a1d*******-cn-hangzhou.alicloudapi.com" -H "Authorization:APPCODE c404eca23959492b9f0e4d4d15****"

HTTP/1.1 200 OK
Date: Tue, 01 Aug 2023 09:41:07 GMT
Content-Type: text/html
Content-Length: 4897
Server: Apache/2.4.6 (CentOS)
X-Ca-Request-Id: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
<html>
<head>
<title>Apache HTTP Server Test Page</title>
</head>
<body>
...
<h1>Testing 123..</h1>
<p>This page is used to test the proper operation of the Apache HTTP server...</p>
...
</body>
</html>