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

# AWS AppSync referensi template pemetaan resolver untuk HTTP
<a name="resolver-mapping-template-reference-http"></a>

**catatan**  
Kami sekarang terutama mendukung runtime APPSYNC\_JS dan dokumentasinya. [Harap pertimbangkan untuk menggunakan runtime APPSYNC\_JS dan panduannya di sini.](https://docs.aws.amazon.com/appsync/latest/devguide/resolver-reference-js-version.html)

Templat pemetaan AWS AppSync HTTP resolver memungkinkan Anda mengirim permintaan dari titik akhir HTTP apa pun, dan tanggapan dari titik akhir HTTP Anda kembali AWS AppSync ke. AWS AppSync Dengan menggunakan template pemetaan, Anda dapat memberikan petunjuk AWS AppSync tentang sifat operasi yang akan dipanggil. Bagian ini menjelaskan template pemetaan yang berbeda untuk resolver HTTP yang didukung.

## Meminta template pemetaan
<a name="request-mapping-template"></a>

```
{
    "version": "2018-05-29",
    "method": "PUT|POST|GET|DELETE|PATCH",
    "params": {
        "query": Map,
        "headers": Map,
        "body": any
    },
    "resourcePath": string
}
```

Setelah template pemetaan permintaan HTTP diselesaikan, representasi skema JSON dari template pemetaan permintaan terlihat seperti berikut:

```
{
    "$id": "https://aws.amazon.com/appsync/request-mapping-template.json",
    "type": "object",
    "properties": {
        "version": {
        "$id": "/properties/version",
        "type": "string",
        "title": "The Version Schema ",
        "default": "",
        "examples": [
            "2018-05-29"
        ],
        "enum": [
            "2018-05-29"
        ]
        },
        "method": {
        "$id": "/properties/method",
        "type": "string",
        "title": "The Method Schema ",
        "default": "",
        "examples": [
            "PUT|POST|GET|DELETE|PATCH"
        ],
        "enum": [
            "PUT",
            "PATCH",
            "POST",
            "DELETE",
            "GET"
        ]
        },
        "params": {
        "$id": "/properties/params",
        "type": "object",
        "properties": {
            "query": {
            "$id": "/properties/params/properties/query",
            "type": "object"
            },
            "headers": {
            "$id": "/properties/params/properties/headers",
            "type": "object"
            },
            "body": {
            "$id": "/properties/params/properties/body",
            "type": "string",
            "title": "The Body Schema ",
            "default": "",
            "examples": [
                ""
            ]
            }
        }
        },
        "resourcePath": {
        "$id": "/properties/resourcePath",
        "type": "string",
        "title": "The Resourcepath Schema ",
        "default": "",
        "examples": [
            ""
        ]
        }
    },
    "required": [
        "version",
        "method",
        "resourcePath"
    ]
}
```

Berikut ini adalah contoh permintaan HTTP POST, dengan `text/plain` badan:

```
{
    "version": "2018-05-29",
    "method": "POST",
    "params": {
        "headers":{
        "Content-Type":"text/plain"
        },
        "body":"this is an example of text body"
    },
    "resourcePath": "/"
}
```

## Versi
<a name="version"></a>

**catatan**  
Ini hanya berlaku untuk template pemetaan Permintaan. 

Mendefinisikan versi yang digunakan template. `version`umum untuk semua templat pemetaan permintaan dan diperlukan.

```
"version": "2018-05-29"
```

## Metode
<a name="method"></a>

**catatan**  
Ini hanya berlaku untuk template pemetaan Permintaan. 

Metode HTTP atau kata kerja (GET, POST, PUT, PATCH, atau DELETE) yang AWS AppSync mengirim ke titik akhir HTTP.

```
"method": "PUT"
```

## ResourcePath
<a name="resourcepath"></a>

**catatan**  
Ini hanya berlaku untuk template pemetaan Permintaan. 

Jalur sumber daya yang ingin Anda akses. Seiring dengan titik akhir di sumber data HTTP, jalur sumber daya membentuk URL tempat AWS AppSync layanan membuat permintaan.

```
"resourcePath": "/v1/users"
```

Ketika template pemetaan dievaluasi, jalur ini dikirim sebagai bagian dari permintaan HTTP, termasuk titik akhir HTTP. Misalnya, contoh sebelumnya mungkin menerjemahkan ke yang berikut:

```
PUT <endpoint>/v1/users
```

## Bidang Params
<a name="params-field"></a>

**catatan**  
Ini hanya berlaku untuk template pemetaan Permintaan. 

Digunakan untuk menentukan tindakan apa yang dilakukan penelusuran Anda, paling sering dengan menetapkan nilai **kueri** di dalam **badan**. Namun, ada beberapa kemampuan lain yang dapat dikonfigurasi, seperti pemformatan respons.

** **header** **  
Informasi header, sebagai pasangan kunci-nilai. Baik kunci dan nilainya harus berupa string.  
Contoh:  

```
"headers" : {
    "Content-Type" : "application/json"
}
```
`Content-Type`Header yang didukung saat ini adalah:  

```
text/*
application/xml
application/json
application/soap+xml
application/x-amz-json-1.0
application/x-amz-json-1.1
application/vnd.api+json
application/x-ndjson
```
 **Catatan**: Anda tidak dapat mengatur header HTTP berikut:  

```
HOST
CONNECTION
USER-AGENT
EXPECTATION
TRANSFER_ENCODING
CONTENT_LENGTH
```

** **query** **  
Pasangan nilai kunci yang menentukan opsi umum, seperti pemformatan kode untuk respons JSON. Baik kunci dan nilainya harus berupa string. Contoh berikut menunjukkan bagaimana Anda dapat mengirim string query sebagai`?type=json`:  

```
"query" : {
    "type" : "json"
}
```

** **tubuh** **  
Tubuh berisi badan permintaan HTTP yang Anda pilih untuk disetel. Badan permintaan selalu berupa string yang dikodekan UTF-8 kecuali jenis konten menentukan charset.  

```
"body":"body string"
```

## Respons
<a name="response"></a>

Lihat contoh [di sini](https://docs.aws.amazon.com/appsync/latest/devguide/tutorial-http-resolvers.html).