---
search:
  tags:
    - Alat
    - POST
seo:
  description: >-
    Panggil alat baca sahaja. Hantar {input: {...}} mengikut skema alat dalam
    laluan. Permintaan JSON dihadkan kepada 65536 bait. Respons 200 boleh
    mengandungi…
sidebar:
  label: Panggil alat baca sahaja
  badge: POST
title: Panggil alat baca sahaja
type: openapi-operation
---
Panggil alat baca sahaja. Hantar {input: {...}} mengikut skema alat dalam laluan. Permintaan JSON dihadkan kepada 65536 bait. Respons 200 boleh mengandungi ok:false.

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

**Badan permintaan** (`application/json`, wajib)

- `input` (object, wajib)

Contoh badan permintaan:

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

**Respons**

- `200` — Hasil alat; semak ok dan error.
- `400` — Permintaan tidak sah. Parameter pertanyaan tidak diterima. Kegagalan pengesahan input boleh menggunakan format ralat alat.
- `401` — Kelayakan bearer tiada, tidak sah atau telah tamat tempoh.
- `403` — Kelayakan akses tidak mempunyai kebenaran yang diperlukan.
- `404` — API atau alat yang diminta tidak tersedia.
- `413` — Permintaan melebihi had bait.
- `429` — Had permintaan telah dilampaui. Permintaan boleh dicuba semula.
- `503` — API atau perkhidmatan yang menjalankan operasi tidak tersedia.

Contoh respons, 200:

```json
{
  "ok": true,
  "output": "string",
  "toolName": "adAuditQuote"
}
```