Ana içeriğe atla

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:
{
  "success": true,
  "data": { ... },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-02-10T12:00:00.000Z"
  }
}
AlanT\u00fcrA\u00e7\u0131klama
successbooleanBa\u015far\u0131l\u0131 yan\u0131tlar i\u00e7in her zaman true
dataobject | arrayYan\u0131t verisi
meta.requestIdstringHata ay\u0131klama i\u00e7in benzersiz istek tan\u0131mlay\u0131c\u0131s\u0131
meta.timestampstringISO 8601 zaman damgas\u0131

Sayfal\u0131 yan\u0131tlar

Liste d\u00f6nd\u00fcren ucu noktalar\u0131 sayfalama \u00fcst verisi i\u00e7erir:
{
  "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:
GET /api/instances?page=2&limit=10

Hata yan\u0131tlar\u0131

Ba\u015far\u0131s\u0131z istekler bir hata nesnesi d\u00f6nd\u00fcr\u00fcr:
{
  "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 DurumuKodA\u00e7\u0131klama
400VALIDATION_ERROR\u0130stek g\u00f6vdesi do\u011frulamay\u0131 ge\u00e7emedi
401UNAUTHORIZEDEksik veya ge\u00e7ersiz kimlik do\u011frulama token’\u0131
403FORBIDDENYetersiz izinler
404NOT_FOUNDKaynak bulunamad\u0131
409PLAN_LIMIT_REACHEDPlan\u0131n\u0131z i\u00e7in \u00f6rnek s\u0131n\u0131r\u0131na ula\u015f\u0131ld\u0131
429RATE_LIMIT_EXCEEDED\u00c7ok fazla istek
500INTERNAL_ERRORBeklenmeyen sunucu hatas\u0131
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.