---
search:
  tags:
    - เครื่องมือ
    - POST
seo:
  description: >-
    เตรียมการเปลี่ยนแปลงด้วย {input: {...}}
    ขั้นตอนนี้ไม่ได้อนุมัติหรือดำเนินการเผยแพร่ เมื่อเตรียมสำเร็จจะส่งคืน
    confirmationCapability และ expiresAt ข้อผิดพลาดของเครื่องมืออาจใช้ HTTP 200…
sidebar:
  label: เตรียมการเปลี่ยนแปลง
  badge: POST
title: เตรียมการเปลี่ยนแปลง
type: openapi-operation
---
เตรียมการเปลี่ยนแปลงด้วย {input: {...}} ขั้นตอนนี้ไม่ได้อนุมัติหรือดำเนินการเผยแพร่ เมื่อเตรียมสำเร็จจะส่งคืน confirmationCapability และ expiresAt ข้อผิดพลาดของเครื่องมืออาจใช้ HTTP 200 ได้เช่นกัน คำขอ JSON มีขนาดได้ไม่เกิน 65536 ไบต์

`POST /api/v1/tools/{tool}/prepare`

**เนื้อหาคำขอ** (`application/json`, จำเป็น)

- `input` (object, จำเป็น)

ตัวอย่างเนื้อหาคำขอ:

```json
{
  "input": {
    "property1": "string",
    "property2": "string"
  }
}
```

**การตอบกลับ**

- `200` — ผลการเตรียมหรือข้อผิดพลาดของเครื่องมือ
- `400` — คำขอไม่ถูกต้อง ไม่รับพารามิเตอร์คิวรี หากตรวจสอบข้อมูลไม่ผ่าน อาจส่งคืนข้อผิดพลาดในรูปแบบของเครื่องมือ
- `401` — ไม่มีข้อมูลยืนยันตัวตนแบบ bearer หรือข้อมูลไม่ถูกต้องหรือหมดอายุ
- `403` — ข้อมูลยืนยันตัวตนไม่มีสิทธิ์ที่จำเป็น
- `404` — API หรือเครื่องมือที่ขอไม่พร้อมใช้งาน
- `413` — คำขอมีขนาดเกินจำนวนไบต์ที่กำหนด
- `429` — เกินขีดจำกัดคำขอ สามารถลองใหม่ได้
- `503` — API หรือบริการที่ประมวลผลคำขอไม่พร้อมใช้งาน

ตัวอย่างการตอบกลับ, 200:

```json
{
  "confirmationCapability": "stringstringstringstringstringst",
  "expiresAt": "2019-08-24T14:15:22Z",
  "inputDigest": "string",
  "status": "confirmation_required",
  "summary": "string",
  "toolName": "adAuditQuote"
}
```