Format odpowiedzi
Wszystkie odpowiedzi Wappfy API stosuja spojny format koperty.
Odpowiedzi pomyslne
Kazda pomyslna odpowiedz jest opakowana w standardowy obiekt:
{
"success": true,
"data": { ... },
"meta": {
"requestId": "req_abc123",
"timestamp": "2026-02-10T12:00:00.000Z"
}
}
| Pole | Typ | Opis |
|---|
success | boolean | Zawsze true dla pomyslnych odpowiedzi |
data | object | array | Dane odpowiedzi |
meta.requestId | string | Unikalny identyfikator zapytania do debugowania |
meta.timestamp | string | Znacznik czasu w formacie ISO 8601 |
Odpowiedzi z paginacja
Endpointy zwracajace listy zawieraja metadane paginacji:
{
"success": true,
"data": {
"items": [ ... ],
"total": 42,
"page": 1,
"limit": 20,
"totalPages": 3
},
"meta": {
"requestId": "req_def456",
"timestamp": "2026-02-10T12:00:00.000Z"
}
}
page i limit do kontrolowania paginacji:
GET /api/instances?page=2&limit=10
Odpowiedzi bledow
Nieudane zapytania zwracaja obiekt bledu:
{
"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"
}
}
Typowe kody bledow
| Status HTTP | Kod | Opis |
|---|
400 | VALIDATION_ERROR | Tresc zapytania nie przeszla walidacji |
401 | UNAUTHORIZED | Brakujacy lub nieprawidlowy token uwierzytelniania |
403 | FORBIDDEN | Niewystarczajace uprawnienia |
404 | NOT_FOUND | Zasob nie istnieje |
409 | PLAN_LIMIT_REACHED | Limit instancji dla Twojego planu |
429 | RATE_LIMIT_EXCEEDED | Zbyt wiele zapytan |
500 | INTERNAL_ERROR | Nieoczekiwany blad serwera |
Pole meta.requestId jest przydatne przy zgloszeniach do wsparcia — dolacz je przy kontakcie z obsluga techniczna, aby przyspieszyc debugowanie.
