> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wappfy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Yanıt Formatı

> Wappfy API yanıtlarının yapısı — standart zarf, sayfalama ve hata formatı.

# Yan\u0131t Format\u0131

T\u00fcm Wappfy API yan\u0131tlar\u0131 tutarl\u0131 bir zarf format\u0131na uyar.

## Ba\u015far\u0131l\u0131 yan\u0131tlar

Her ba\u015far\u0131l\u0131 yan\u0131t standart bir nesne i\u00e7ine sar\u0131l\u0131r:

```json theme={null}
{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-02-10T12:00:00.000Z"
  }
}
```

| Alan             | T\u00fcr          | A\u00e7\u0131klama                                                             |
| ---------------- | ----------------- | ------------------------------------------------------------------------------ |
| `success`        | `boolean`         | Ba\u015far\u0131l\u0131 yan\u0131tlar i\u00e7in her zaman `true`               |
| `data`           | `object \| array` | Yan\u0131t verisi                                                              |
| `meta.requestId` | `string`          | Hata ay\u0131klama i\u00e7in benzersiz istek tan\u0131mlay\u0131c\u0131s\u0131 |
| `meta.timestamp` | `string`          | ISO 8601 zaman damgas\u0131                                                    |

## Sayfal\u0131 yan\u0131tlar

Liste d\u00f6nd\u00fcren ucu noktalar\u0131 sayfalama \u00fcst verisi i\u00e7erir:

```json theme={null}
{
  "success": true,
  "data": {
    "items": [ ... ],
    "total": 42,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  },
  "meta": {
    "requestId": "req_def456",
    "timestamp": "2026-02-10T12:00:00.000Z"
  }
}
```

Sayfalamay\u0131 kontrol etmek i\u00e7in `page` ve `limit` sorgu parametrelerini kullan\u0131n:

```bash theme={null}
GET /api/instances?page=2&limit=10
```

## Hata yan\u0131tlar\u0131

Ba\u015far\u0131s\u0131z istekler bir hata nesnesi d\u00f6nd\u00fcr\u00fcr:

```json theme={null}
{
  "success": false,
  "error": {
    "code": "INSTANCE_NOT_FOUND",
    "message": "Instance with ID abc123 not found",
    "details": {}
  },
  "meta": {
    "requestId": "req_ghi789",
    "timestamp": "2026-02-10T12:00:00.000Z"
  }
}
```

### Yayg\u0131n hata kodlar\u0131

| HTTP Durumu | Kod                   | A\u00e7\u0131klama                                                                      |
| ----------- | --------------------- | --------------------------------------------------------------------------------------- |
| `400`       | `VALIDATION_ERROR`    | \u0130stek g\u00f6vdesi do\u011frulamay\u0131 ge\u00e7emedi                             |
| `401`       | `UNAUTHORIZED`        | Eksik veya ge\u00e7ersiz kimlik do\u011frulama token'\u0131                             |
| `403`       | `FORBIDDEN`           | Yetersiz izinler                                                                        |
| `404`       | `NOT_FOUND`           | Kaynak bulunamad\u0131                                                                  |
| `409`       | `PLAN_LIMIT_REACHED`  | Plan\u0131n\u0131z i\u00e7in \u00f6rnek s\u0131n\u0131r\u0131na ula\u015f\u0131ld\u0131 |
| `429`       | `RATE_LIMIT_EXCEEDED` | \u00c7ok fazla istek                                                                    |
| `500`       | `INTERNAL_ERROR`      | Beklenmeyen sunucu hatas\u0131                                                          |

<Note>
  `meta.requestId` destek talepleri i\u00e7in kullan\u0131\u015fl\u0131d\u0131r \u2014 daha h\u0131zl\u0131 hata ay\u0131klama i\u00e7in destek ile ileti\u015fime ge\u00e7ti\u011finizde bunu ekleyin.
</Note>