View a markdown version of this page

Panggil API menggunakan klien REST API - Amazon API Gateway

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Panggil API menggunakan klien REST API

Untuk memberikan tutorial end-to-end, sekarang kami menunjukkan cara memanggil API menggunakan Postman, yang mendukung otorisasi AWS IAM.

Untuk memanggil API proxy Amazon S3 kami menggunakan Postman
  1. Menyebarkan atau menyebarkan ulang API. Catat URL dasar API yang ditampilkan di sebelah Invoke URL di bagian atas Editor St age.

  2. Luncurkan Postman.

  3. Pilih Otorisasi dan kemudian pilihAWS Signature. Masukkan ID Kunci Akses pengguna IAM dan Kunci Akses Rahasia ke dalam AccessKey kolom dan SecretKey input, masing-masing. Masukkan API Wilayah AWS yang digunakan di kotak teks AWS Wilayah. Masukkan execute-api di bidang input Nama Layanan.

    Anda dapat membuat sepasang kunci dari tab Kreden si Keamanan dari akun pengguna IAM Anda di Konsol Manajemen IAM.

  4. Untuk menambahkan bucket bernama amzn-s3-demo-bucket ke akun Amazon S3 Anda di {region} wilayah tersebut:

    1. Pilih PUT dari daftar metode drop-down dan ketik metode URL (https://api-id.execute-api.aws-region.amazonaws.com/stage/folder-name

    2. Tetapkan nilai Content-Type header sebagaiapplication/xml. Anda mungkin perlu menghapus header yang ada sebelum mengatur jenis konten.

    3. Pilih item menu Body dan ketik fragmen XML berikut sebagai badan permintaan:

      <CreateBucketConfiguration> <LocationConstraint>{region}</LocationConstraint> </CreateBucketConfiguration>
    4. Pilih Kirim untuk mengirimkan permintaan. Jika berhasil, Anda akan menerima 200 OK respons dengan muatan kosong.

  5. Untuk menambahkan file teks ke bucket, ikuti petunjuk di atas. Jika Anda menentukan nama bucket amzn-s3-demo-bucket for {folder} dan nama file Readme.txt for {item} di URL dan memberikan string teks Hello, World! sebagai konten file (sehingga menjadikannya payload permintaan), permintaan menjadi

    PUT /S3/amzn-s3-demo-bucket/Readme.txt HTTP/1.1 Host: 9gn28ca086.execute-api.{region}.amazonaws.com Content-Type: application/xml X-Amz-Date: 20161015T062647Z Authorization: AWS4-HMAC-SHA256 Credential=access-key-id/20161015/{region}/execute-api/aws4_request, SignedHeaders=content-length;content-type;host;x-amz-date, Signature=ccadb877bdb0d395ca38cc47e18a0d76bb5eaf17007d11e40bf6fb63d28c705b Cache-Control: no-cache Postman-Token: 6135d315-9cc4-8af8-1757-90871d00847e Hello, World!

    Jika semuanya berjalan dengan baik, Anda harus menerima 200 OK respons dengan muatan kosong.

  6. Untuk mendapatkan konten Readme.txt file yang baru saja kita tambahkan ke amzn-s3-demo-bucket bucket, lakukan permintaan GET seperti berikut ini:

    GET /S3/amzn-s3-demo-bucket/Readme.txt HTTP/1.1 Host: 9gn28ca086.execute-api.{region}.amazonaws.com Content-Type: application/xml X-Amz-Date: 20161015T063759Z Authorization: AWS4-HMAC-SHA256 Credential=access-key-id/20161015/{region}/execute-api/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=ba09b72b585acf0e578e6ad02555c00e24b420b59025bc7bb8d3f7aed1471339 Cache-Control: no-cache Postman-Token: d60fcb59-d335-52f7-0025-5bd96928098a

    Jika berhasil, Anda akan menerima 200 OK respons dengan string Hello, World! teks sebagai payload.

  7. Untuk mencantumkan item dalam amzn-s3-demo-bucket bucket, kirimkan permintaan berikut:

    GET /S3/amzn-s3-demo-bucket HTTP/1.1 Host: 9gn28ca086.execute-api.{region}.amazonaws.com Content-Type: application/xml X-Amz-Date: 20161015T064324Z Authorization: AWS4-HMAC-SHA256 Credential=access-key-id/20161015/{region}/execute-api/aws4_request, SignedHeaders=content-type;host;x-amz-date, Signature=4ac9bd4574a14e01568134fd16814534d9951649d3a22b3b0db9f1f5cd4dd0ac Cache-Control: no-cache Postman-Token: 9c43020a-966f-61e1-81af-4c49ad8d1392

    Jika berhasil, Anda akan menerima 200 OK respons dengan payload XML yang menunjukkan satu item dalam bucket yang ditentukan, kecuali Anda menambahkan lebih banyak file ke bucket sebelum mengirimkan permintaan ini.

    <?xml version="1.0" encoding="UTF-8"?> <ListBucketResult xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <Name>apig-demo-5</Name> <Prefix></Prefix> <Marker></Marker> <MaxKeys>1000</MaxKeys> <IsTruncated>false</IsTruncated> <Contents> <Key>Readme.txt</Key> <LastModified>2016-10-15T06:26:48.000Z</LastModified> <ETag>"65a8e27d8879283831b664bd8b7f0ad4"</ETag> <Size>13</Size> <Owner> <ID>06e4b09e9d...603addd12ee</ID> <DisplayName>user-name</DisplayName> </Owner> <StorageClass>STANDARD</StorageClass> </Contents> </ListBucketResult>
catatan

Untuk mengunggah atau mengunduh gambar, Anda perlu mengatur penanganan konten ke CONVERT_TO_BINARY.