Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Pemetaan parameter untuk REST APIs di API Gateway
**catatan**
Jika Anda menggunakan API HTTP, lihat[Mengubah permintaan dan tanggapan API untuk HTTP APIs di API Gateway](http-api-parameter-mapping.md).
Dalam pemetaan parameter, Anda memetakan parameter permintaan atau respons. Anda dapat memetakan parameter menggunakan ekspresi pemetaan parameter atau nilai statis. Untuk daftar ekspresi pemetaan, lihat[Referensi sumber pemetaan parameter untuk REST APIs di API Gateway](rest-api-parameter-mapping-sources.md). Anda dapat menggunakan pemetaan parameter dalam permintaan integrasi untuk integrasi proxy dan non-proxy, tetapi untuk menggunakan pemetaan parameter untuk respons integrasi, Anda memerlukan integrasi non-proxy.
Misalnya, Anda dapat memetakan parameter header permintaan metode `puppies` ke parameter header permintaan integrasi`DogsAge0`. Kemudian, jika klien mengirim header `puppies:true` ke API Anda, permintaan integrasi mengirimkan header permintaan `DogsAge0:true` ke titik akhir integrasi. Diagram berikut menunjukkan siklus hidup permintaan dari contoh ini.
![\[Diagram contoh pemetaan parameter API Gateway untuk permintaan\]](http://docs.aws.amazon.com/id_id/apigateway/latest/developerguide/images/parameter-mapping-example1.png)
Untuk membuat contoh ini menggunakan API Gateway, lihat[Contoh 1: Petakan parameter permintaan metode ke parameter permintaan integrasi](request-response-data-mappings.md#request-response-data-mappings-example-1).
Sebagai contoh lain, Anda juga dapat memetakan parameter header respons integrasi `kittens` ke parameter header respons metode`CatsAge0`. Kemudian, jika titik akhir integrasi kembali`kittens:false`, klien menerima header`CatsAge0:false`. Diagram berikut menunjukkan siklus hidup permintaan dari contoh ini.
![\[Diagram contoh pemetaan parameter API Gateway untuk respons\]](http://docs.aws.amazon.com/id_id/apigateway/latest/developerguide/images/parameter-mapping-example2.png)
**Topics**
+ [Contoh pemetaan parameter untuk REST APIs di API Gateway](request-response-data-mappings.md)
+ [Referensi sumber pemetaan parameter untuk REST APIs di API Gateway](rest-api-parameter-mapping-sources.md)
# Contoh pemetaan parameter untuk REST APIs di API Gateway
Contoh berikut menunjukkan cara membuat ekspresi pemetaan parameter menggunakan konsol API Gateway, OpenAPI, CloudFormation dan template. Untuk contoh cara menggunakan pemetaan parameter untuk membuat header CORS yang diperlukan, lihat. [CORS untuk REST APIs di API Gateway](how-to-cors.md)
## Contoh 1: Petakan parameter permintaan metode ke parameter permintaan integrasi
Contoh berikut memetakan parameter header permintaan metode `puppies` ke parameter header permintaan integrasi`DogsAge0`.
------
#### [ Konsol Manajemen AWS ]
**Untuk memetakan parameter permintaan metode**
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Pilih REST API.
1. Pilih metode.
Metode Anda harus memiliki integrasi non-proxy.
1. Untuk **pengaturan permintaan Metode**, pilih **Edit**.
1. Pilih **header permintaan HTTP**.
1. Pilih **Tambahkan header**.
1. Untuk **Nama**, masukkan **puppies**.
1. Pilih **Simpan**.
1. Pilih tab **Permintaan integrasi**, dan kemudian untuk **pengaturan permintaan Integrasi**, pilih **Edit**.
Konsol Manajemen AWS Secara otomatis menambahkan pemetaan parameter dari `method.request.header.puppies ` ke `puppies` untuk Anda, tetapi Anda perlu mengubah **Nama** agar sesuai dengan parameter header permintaan yang diharapkan oleh titik akhir integrasi Anda.
1. Untuk **Nama**, masukkan **DogsAge0**.
1. Pilih **Simpan**.
1. Menerapkan ulang API Anda agar perubahan diterapkan.
Langkah-langkah berikut menunjukkan cara memverifikasi bahwa pemetaan parameter Anda berhasil.
**(Opsional) Uji pemetaan parameter Anda**
1. Pilih tab **Uji**. Anda mungkin perlu memilih tombol panah kanan untuk menampilkan tab.
1. Untuk header, masukkan**puppies:true**.
1. Pilih **Uji**.
1. Dalam **Log**, hasilnya akan terlihat seperti berikut:
```
Tue Feb 04 00:28:36 UTC 2025 : Method request headers: {puppies=true}
Tue Feb 04 00:28:36 UTC 2025 : Method request body before transformations:
Tue Feb 04 00:28:36 UTC 2025 : Endpoint request URI: http://petstore-demo-endpoint.execute-api.com/petstore/pets
Tue Feb 04 00:28:36 UTC 2025 : Endpoint request headers: {DogsAge0=true, x-amzn-apigateway-api-id=abcd1234, Accept=application/json, User-Agent=AmazonAPIGateway_aaaaaaa, X-Amzn-Trace-Id=Root=1-abcd-12344}
```
Parameter header permintaan telah berubah dari `puppies` menjadi`DogsAge0`.
------
#### [ CloudFormation ]
Dalam contoh ini, Anda menggunakan properti [body](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html#cfn-apigateway-restapi-body) untuk mengimpor file definisi OpenAPI ke API Gateway.
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
Api:
Type: 'AWS::ApiGateway::RestApi'
Properties:
Body:
openapi: 3.0.1
info:
title: ParameterMappingExample
version: "2025-02-04T00:30:41Z"
paths:
/pets:
get:
parameters:
- name: puppies
in: header
schema:
type: string
responses:
"200":
description: 200 response
x-amazon-apigateway-integration:
httpMethod: GET
uri: http://petstore-demo-endpoint.execute-api.com/petstore/pets
responses:
default:
statusCode: "200"
requestParameters:
integration.request.header.DogsAge0: method.request.header.puppies
passthroughBehavior: when_no_match
type: http
ApiGatewayDeployment:
Type: 'AWS::ApiGateway::Deployment'
DependsOn: Api
Properties:
RestApiId: !Ref Api
ApiGatewayDeployment20250219:
Type: 'AWS::ApiGateway::Deployment'
DependsOn: Api
Properties:
RestApiId: !Ref Api
Stage:
Type: 'AWS::ApiGateway::Stage'
Properties:
DeploymentId: !Ref ApiGatewayDeployment20250219
RestApiId: !Ref Api
StageName: prod
```
------
#### [ OpenAPI ]
```
{
"openapi" : "3.0.1",
"info" : {
"title" : "ParameterMappingExample",
"version" : "2025-02-04T00:30:41Z"
},
"paths" : {
"/pets" : {
"get" : {
"parameters" : [ {
"name" : "puppies",
"in" : "header",
"schema" : {
"type" : "string"
}
} ],
"responses" : {
"200" : {
"description" : "200 response"
}
},
"x-amazon-apigateway-integration" : {
"httpMethod" : "GET",
"uri" : "http://petstore-demo-endpoint.execute-api.com/petstore/pets",
"responses" : {
"default" : {
"statusCode" : "200"
}
},
"requestParameters" : {
"integration.request.header.DogsAge0" : "method.request.header.puppies"
},
"passthroughBehavior" : "when_no_match",
"type" : "http"
}
}
}
}
}
```
------
## Contoh 2: Petakan beberapa parameter permintaan metode ke parameter permintaan integrasi yang berbeda
Contoh berikut memetakan parameter string permintaan metode multi-nilai `methodRequestQueryParam` ke parameter string kueri permintaan integrasi `integrationQueryParam` dan memetakan parameter header permintaan metode `methodRequestHeaderParam` ke parameter `integrationPathParam` jalur permintaan integrasi.
------
#### [ Konsol Manajemen AWS ]
**Untuk memetakan parameter permintaan metode**
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Pilih REST API.
1. Pilih metode.
Metode Anda harus memiliki integrasi non-proxy.
1. Untuk **pengaturan permintaan Metode**, pilih **Edit**.
1. Pilih **parameter string kueri URL**.
1. Pilih **Tambahkan string kueri**.
1. Untuk **Nama**, masukkan **methodRequestQueryParam**.
1. Pilih **header permintaan HTTP**.
1. Pilih **Tambahkan header**.
1. Untuk **Nama**, masukkan **methodRequestHeaderParam**.
1. Pilih **Simpan**.
1. Pilih tab **Permintaan integrasi**, dan kemudian untuk **pengaturan permintaan Integrasi**, pilih **Edit**.
1. Pilih **parameter jalur URL**.
1. Pilih **Tambahkan parameter jalur**.
1. Untuk **Nama**, masukkan **integrationPathParam**.
1. Untuk **Dipetakan dari**, masukkan**method.request.header.methodRequestHeaderParam**.
Ini memetakan header permintaan metode yang Anda tentukan dalam permintaan metode ke parameter jalur permintaan integrasi baru.
1. Pilih **parameter string kueri URL**.
1. Pilih **Tambahkan string kueri**.
1. Untuk **Nama**, masukkan **integrationQueryParam**.
1. Untuk **Dipetakan dari**, masukkan**method.request.multivaluequerystring.methodRequestQueryParam**.
Ini memetakan parameter string kueri multivalue ke parameter string kueri permintaan integrasi bernilai tunggal baru.
1. Pilih **Simpan**.
1. Menerapkan ulang API Anda agar perubahan diterapkan.
------
#### [ CloudFormation ]
Dalam contoh ini, Anda menggunakan properti [body](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html#cfn-apigateway-restapi-body) untuk mengimpor file definisi OpenAPI ke API Gateway.
Definisi OpenAPI berikut membuat pemetaan parameter berikut untuk integrasi HTTP:
+ Header permintaan metode, bernama`methodRequestHeaderParam`, ke dalam parameter jalur permintaan integrasi, bernama `integrationPathParam`
+ Metode multi-nilai meminta string kueri, bernama`methodRequestQueryParam`, ke dalam string permintaan permintaan integrasi, bernama `integrationQueryParam`
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
Api:
Type: 'AWS::ApiGateway::RestApi'
Properties:
Body:
openapi: 3.0.1
info:
title: Parameter mapping example 2
version: "2025-01-15T19:12:31Z"
paths:
/:
post:
parameters:
- name: methodRequestQueryParam
in: query
schema:
type: string
- name: methodRequestHeaderParam
in: header
schema:
type: string
responses:
"200":
description: 200 response
x-amazon-apigateway-integration:
httpMethod: GET
uri: http://petstore-demo-endpoint.execute-api.com/petstore/pets
responses:
default:
statusCode: "200"
requestParameters:
integration.request.querystring.integrationQueryParam: method.request.multivaluequerystring.methodRequestQueryParam
integration.request.path.integrationPathParam: method.request.header.methodRequestHeaderParam
requestTemplates:
application/json: '{"statusCode": 200}'
passthroughBehavior: when_no_templates
timeoutInMillis: 29000
type: http
ApiGatewayDeployment:
Type: 'AWS::ApiGateway::Deployment'
DependsOn: Api
Properties:
RestApiId: !Ref Api
ApiGatewayDeployment20250219:
Type: 'AWS::ApiGateway::Deployment'
DependsOn: Api
Properties:
RestApiId: !Ref Api
Stage:
Type: 'AWS::ApiGateway::Stage'
Properties:
DeploymentId: !Ref ApiGatewayDeployment20250219
RestApiId: !Ref Api
StageName: prod
```
------
#### [ OpenAPI ]
Definisi OpenAPI berikut membuat pemetaan parameter berikut untuk integrasi HTTP:
+ Header permintaan metode, bernama`methodRequestHeaderParam`, ke dalam parameter jalur permintaan integrasi, bernama `integrationPathParam`
+ Metode multi-nilai meminta string kueri, bernama`methodRequestQueryParam`, ke dalam string permintaan permintaan integrasi, bernama `integrationQueryParam`
```
{
"openapi" : "3.0.1",
"info" : {
"title" : "Parameter mapping example 2",
"version" : "2025-01-15T19:12:31Z"
},
"paths" : {
"/" : {
"post" : {
"parameters" : [ {
"name" : "methodRequestQueryParam",
"in" : "query",
"schema" : {
"type" : "string"
}
}, {
"name" : "methodRequestHeaderParam",
"in" : "header",
"schema" : {
"type" : "string"
}
} ],
"responses" : {
"200" : {
"description" : "200 response"
}
},
"x-amazon-apigateway-integration" : {
"httpMethod" : "GET",
"uri" : "http://petstore-demo-endpoint.execute-api.com/petstore/pets",
"responses" : {
"default" : {
"statusCode" : "200"
}
},
"requestParameters" : {
"integration.request.querystring.integrationQueryParam" : "method.request.multivaluequerystring.methodRequestQueryParam",
"integration.request.path.integrationPathParam" : "method.request.header.methodRequestHeaderParam"
},
"requestTemplates" : {
"application/json" : "{\"statusCode\": 200}"
},
"passthroughBehavior" : "when_no_templates",
"timeoutInMillis" : 29000,
"type" : "http"
}
}
}
}
}
```
------
## Contoh 3: Memetakan bidang dari badan permintaan JSON ke parameter permintaan integrasi
Anda juga dapat memetakan parameter permintaan integrasi dari bidang di badan permintaan JSON menggunakan [JSONPath ekspresi](http://goessner.net/articles/JsonPath/index.html#e2). Contoh berikut memetakan badan permintaan metode ke header permintaan integrasi bernama `body-header` dan memetakan bagian dari badan permintaan, seperti yang dinyatakan oleh ekspresi JSON ke header permintaan integrasi bernama`pet-price`.
Untuk menguji contoh ini, berikan masukan yang berisi kategori harga, seperti berikut ini:
```
[
{
"id": 1,
"type": "dog",
"price": 249.99
}
]
```
------
#### [ Konsol Manajemen AWS ]
**Untuk memetakan parameter permintaan metode**
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Pilih REST API.
1. Pilih`POST`,, `PUT``PATCH`, atau `ANY` metode.
Metode Anda harus memiliki integrasi non-proxy.
1. Untuk **pengaturan permintaan Integrasi**, pilih **Edit**.
1. Pilih **parameter header permintaan URL**.
1. Pilih **Tambahkan parameter header permintaan**.
1. Untuk **Nama**, masukkan **body-header**.
1. Untuk **Dipetakan dari**, masukkan**method.request.body**.
Ini memetakan badan permintaan metode ke parameter header permintaan integrasi baru.
1. Pilih **Tambahkan parameter header permintaan**.
1. Untuk **Nama**, masukkan **pet-price**.
1. Untuk **Dipetakan dari**, masukkan** method.request.body[0].price**.
Ini memetakan bagian dari badan permintaan metode ke parameter header permintaan integrasi baru.
1. Pilih **Simpan**.
1. Menerapkan ulang API Anda agar perubahan diterapkan.
------
#### [ CloudFormation ]
Dalam contoh ini, Anda menggunakan properti [body](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html#cfn-apigateway-restapi-body) untuk mengimpor file definisi OpenAPI ke API Gateway.
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
Api:
Type: 'AWS::ApiGateway::RestApi'
Properties:
Body:
openapi: 3.0.1
info:
title: Parameter mapping example 3
version: "2025-01-15T19:19:14Z"
paths:
/:
post:
responses:
"200":
description: 200 response
x-amazon-apigateway-integration:
httpMethod: GET
uri: http://petstore-demo-endpoint.execute-api.com/petstore/pets
responses:
default:
statusCode: "200"
requestParameters:
integration.request.header.pet-price: method.request.body[0].price
integration.request.header.body-header: method.request.body
requestTemplates:
application/json: '{"statusCode": 200}'
passthroughBehavior: when_no_templates
timeoutInMillis: 29000
type: http
ApiGatewayDeployment:
Type: 'AWS::ApiGateway::Deployment'
DependsOn: Api
Properties:
RestApiId: !Ref Api
ApiGatewayDeployment20250219:
Type: 'AWS::ApiGateway::Deployment'
DependsOn: Api
Properties:
RestApiId: !Ref Api
Stage:
Type: 'AWS::ApiGateway::Stage'
Properties:
DeploymentId: !Ref ApiGatewayDeployment20250219
RestApiId: !Ref Api
StageName: prod
```
------
#### [ OpenAPI ]
Parameter permintaan integrasi peta definisi OpenAPI berikut dari bidang di badan permintaan JSON.
```
{
"openapi" : "3.0.1",
"info" : {
"title" : "Parameter mapping example 3",
"version" : "2025-01-15T19:19:14Z"
},
"paths" : {
"/" : {
"post" : {
"responses" : {
"200" : {
"description" : "200 response"
}
},
"x-amazon-apigateway-integration" : {
"httpMethod" : "GET",
"uri" : "http://petstore-demo-endpoint.execute-api.com/petstore/pets",
"responses" : {
"default" : {
"statusCode" : "200"
}
},
"requestParameters" : {
"integration.request.header.pet-price" : "method.request.body[0].price",
"integration.request.header.body-header" : "method.request.body"
},
"requestTemplates" : {
"application/json" : "{\"statusCode\": 200}"
},
"passthroughBehavior" : "when_no_templates",
"timeoutInMillis" : 29000,
"type" : "http"
}
}
}
}
}
```
------
## Contoh 4: Petakan respons integrasi terhadap respons metode
Anda juga dapat memetakan respons integrasi ke respons metode. Contoh berikut memetakan badan respons integrasi ke header respons metode bernama`location`, memetakan header respons integrasi `x-app-id` ke header respons metode`id`, dan memetakan header respons integrasi multi-nilai `item` ke header `items` respons metode.
------
#### [ Konsol Manajemen AWS ]
**Untuk memetakan respon integrasi**
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Pilih REST API.
1. Pilih metode.
Metode Anda harus memiliki integrasi non-proxy.
1. Pilih tab **respons Metode**, dan kemudian untuk **Respons 200**, pilih **Edit**.
1. Untuk **nama Header**, pilih **Tambahkan header**.
1. Buat tiga header bernama**id**,**item**, dan**location**.
1. Pilih **Simpan**.
1. Pilih tab **Integrasi respon**, dan kemudian untuk **Default - Respons**, pilih **Edit**.
1. Di bawah **pemetaan Header**, masukkan yang berikut ini.
1. Untuk **id**, masukkan **integration.response.header.x-app-id**
1. Untuk **item**, masukkan **integration.response.multivalueheader.item**
1. Untuk **lokasi**, masukkan **integration.response.body.redirect.url**
1. Pilih **Simpan**.
1. Menerapkan ulang API Anda agar perubahan diterapkan.
------
#### [ CloudFormation ]
Dalam contoh ini, Anda menggunakan properti [body](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html#cfn-apigateway-restapi-body) untuk mengimpor file definisi OpenAPI ke API Gateway.
```
AWSTemplateFormatVersion: 2010-09-09
Resources:
Api:
Type: 'AWS::ApiGateway::RestApi'
Properties:
Body:
openapi: 3.0.1
info:
title: Parameter mapping example
version: "2025-01-15T19:21:35Z"
paths:
/:
post:
responses:
"200":
description: 200 response
headers:
item:
schema:
type: string
location:
schema:
type: string
id:
schema:
type: string
x-amazon-apigateway-integration:
type: http
httpMethod: GET
uri: http://petstore-demo-endpoint.execute-api.com/petstore/pets
responses:
default:
statusCode: "200"
responseParameters:
method.response.header.id: integration.response.header.x-app-id
method.response.header.location: integration.response.body.redirect.url
method.response.header.item: integration.response.multivalueheader.item
requestTemplates:
application/json: '{"statusCode": 200}'
passthroughBehavior: when_no_templates
timeoutInMillis: 29000
ApiGatewayDeployment:
Type: 'AWS::ApiGateway::Deployment'
DependsOn: Api
Properties:
RestApiId: !Ref Api
ApiGatewayDeployment20250219:
Type: 'AWS::ApiGateway::Deployment'
DependsOn: Api
Properties:
RestApiId: !Ref Api
Stage:
Type: 'AWS::ApiGateway::Stage'
Properties:
DeploymentId: !Ref ApiGatewayDeployment20250219
RestApiId: !Ref Api
StageName: prod
```
------
#### [ OpenAPI ]
Definisi OpenAPI berikut memetakan respons integrasi terhadap respons metode.
```
{
"openapi" : "3.0.1",
"info" : {
"title" : "Parameter mapping example",
"version" : "2025-01-15T19:21:35Z"
},
"paths" : {
"/" : {
"post" : {
"responses" : {
"200" : {
"description" : "200 response",
"headers" : {
"item" : {
"schema" : {
"type" : "string"
}
},
"location" : {
"schema" : {
"type" : "string"
}
},
"id" : {
"schema" : {
"type" : "string"
}
}
}
}
},
"x-amazon-apigateway-integration" : {
"type" : "http",
"httpMethod" : "GET",
"uri" : "http://petstore-demo-endpoint.execute-api.com/petstore/pets",
"responses" : {
"default" : {
"statusCode" : "200",
"responseParameters" : {
"method.response.header.id" : "integration.response.header.x-app-id",
"method.response.header.location" : "integration.response.body.redirect.url",
"method.response.header.item" : "integration.response.multivalueheader.item"
}
}
},
"requestTemplates" : {
"application/json" : "{\"statusCode\": 200}"
},
"passthroughBehavior" : "when_no_templates",
"timeoutInMillis" : 29000
}
}
}
}
}
```
------
# Referensi sumber pemetaan parameter untuk REST APIs di API Gateway
Saat Anda membuat pemetaan parameter, Anda menentukan permintaan metode atau parameter respons integrasi untuk dimodifikasi dan Anda menentukan cara memodifikasi parameter tersebut.
Tabel berikut menunjukkan parameter permintaan metode yang dapat Anda petakan, dan ekspresi untuk membuat pemetaan. Dalam ekspresi ini, *name* adalah nama parameter permintaan metode. Misalnya, untuk memetakan parameter header permintaan`puppies`, gunakan ekspresi`method.request.header.puppies`. Ekspresi Anda harus sesuai dengan ekspresi reguler`'^[a-zA-Z0-9._$-]+$]'`. Anda dapat menggunakan pemetaan parameter dalam permintaan integrasi untuk integrasi proxy dan non-proxy.
| **Sumber data yang dipetakan** | **Ekspresi pemetaan** |
| --- | --- |
| Jalur permintaan metode | method.request.path.name |
| String kueri permintaan metode | method.request.querystring.name |
| String kueri permintaan metode multi-nilai | method.request.multivaluequerystring.name |
| Header permintaan metode | method.request.header.name |
| Header permintaan metode multi-nilai | method.request.multivalueheader.name |
| Badan permintaan metode | method.request.body |
| Metode permintaan badan (JsonPath) | `method.request.body.JSONPath_EXPRESSION`. *JSONPath\$1EXPRESSION*adalah JSONPath ekspresi untuk bidang JSON dari badan permintaan. Untuk informasi lebih lanjut, lihat [JSONPath ekspresi](http://goessner.net/articles/JsonPath/index.html#e2). |
| Variabel tahap | stageVariables.name |
| Variabel konteks | `context.name` Nama harus menjadi salah satu [variabel konteks yang didukung](api-gateway-mapping-template-reference.md#context-variable-reference). |
| Nilai statis | `'static_value'`. *static\$1value*Ini adalah string literal dan harus diapit dalam sepasang tanda kutip tunggal. Misalnya, `'https://www.example.com'`. |
Tabel berikut menunjukkan parameter respons integrasi yang dapat Anda petakan dan ekspresi untuk membuat pemetaan. Dalam ekspresi ini, *name* adalah nama parameter respons integrasi. Anda dapat memetakan header respons metode dari header respons integrasi atau badan respons integrasi, variabel \$1context, atau nilai statis. Untuk menggunakan pemetaan parameter untuk respons integrasi, Anda memerlukan integrasi non-proxy.
| Sumber data yang dipetakan | Ekspresi pemetaan |
| --- | --- |
| Header respon integrasi | integration.response.header.name |
| Header respon integrasi | integration.response.multivalueheader.name |
| Badan respons integrasi | integration.response.body |
| Integrasi respon body (JsonPath) | `integration.response.body.JSONPath_EXPRESSION` *JSONPath\$1EXPRESSION*adalah JSONPath ekspresi untuk bidang JSON dari tubuh respons. Untuk informasi lebih lanjut, lihat [JSONPath ekspresi](http://goessner.net/articles/JsonPath/index.html#e2). |
| Variabel tahap | stageVariables.name |
| Variabel konteks | `context.name` Nama harus menjadi salah satu [variabel konteks yang didukung](api-gateway-mapping-template-reference.md#context-variable-reference). |
| Nilai statis | ` 'static_value'` *static\$1value*Ini adalah string literal dan harus diapit dalam sepasang tanda kutip tunggal. Misalnya, `'https://www.example.com'`. |