# Toplu maskele

Birden çok metni tek istekte maskeler. Yanıt, girdi sırasıyla eşlenir. Uzunluk sınırı, birleştirilmiş toplam metin üzerinden uygulanır.

POST `/mask/batch`

## Request body

required `application/json`

`texts` string[] required

Maskelenecek metin listesi.

`transform` string

default: "placeholder"

Allowed: `placeholder` `mask` `surrogate`

`return_vault` boolean

default: false

## Responses

200 Her girdi için maskeleme sonucu

`results` MaskResponse[]

Array of `MaskResponse`

`masked_text` string

Maskelenmiş metin.

`transform` string

`spans` Span[]

Array of `Span`

`category` string

`start` integer

`end` integer

`score` number

`timings_ms` object

Toplam işlem süresi (ms): yalnız { total }.

`vault` object

return_vault=true ise yer-tutucu → orijinal eşlemesi (hassas).

401 Eksik veya geçersiz sanal anahtar

413 Çok fazla metin veya birleştirilmiş toplam metin uzunluk sınırını aştı

422 Geçersiz istek gövdesi

`detail` ValidationError[]

Array of `ValidationError`

`loc` string | integer[]

Array of `string | integer`

Any of:

string

`string`

integer

`integer`

`msg` string

`type` string

### Request

#### python

```
import requests

response = requests.post(
    "https://gw-tr.gurubase.io/mask/batch",
    headers={
        "Content-Type": "application/json"
    },
    json={
  "texts": [
    "Ahmet Yılmaz aradı.",
    "IBAN: TR12 0001 0000 0000 0000 0000 01"
  ]
},
)
```

#### curl

```
curl -X POST "https://gw-tr.gurubase.io/mask/batch" \
  -H "Content-Type: application/json" \
  -d '{
  "texts": [
    "Ahmet Yılmaz aradı.",
    "IBAN: TR12 0001 0000 0000 0000 0000 01"
  ]
}'
```

#### js

```
const response = await fetch("https://gw-tr.gurubase.io/mask/batch", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "texts": [
    "Ahmet Yılmaz aradı.",
    "IBAN: TR12 0001 0000 0000 0000 0000 01"
  ]
})
});
```

### Response

#### 200

```
{
  "results": [
    {
      "masked_text": "string",
      "transform": "string",
      "spans": [
        {
          "category": "person",
          "start": 0,
          "end": 0,
          "score": 0.85
        }
      ],
      "timings_ms": {},
      "vault": {}
    }
  ]
}
```

#### 401

Eksik veya geçersiz sanal anahtar

#### 413

Çok fazla metin veya birleştirilmiş toplam metin uzunluk sınırını aştı

#### 422

```
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}
```
