Schematy danych
Ustrukturyzowane informacje o błędzie
ApiError · Schemat · Wspólne modele danych
codeTekstWymaganeStały kod przeznaczony do przetwarzania przez integrację.
Ograniczenia
enum["request.malformed", "authentication.required", "authentication.invalid_credentials", "authorization.scope_denied", "authorization.ip_not_allowed", "authorization.client_ip_unverified", "entitlements.api_disabled", "entitlements.operation_disabled", "entitlements.limit_exceeded", "entitlements.resource_blocked", "resource.not_found", "request.method_not_allowed", "resource.version_conflict", "resource.state_conflict", "resource.in_use", "resource.already_exists", "idempotency.key_reused", "request.too_large", "request.unsupported_media_type", "request.validation_failed", "rate_limit.exceeded", "capacity.queue_full", "capacity.wait_timeout", "internal.error", "gateway.bad_response", "service.unavailable", "gateway.timeout"]
fieldsTablica <FieldError> nullOpcjonalneBłędy walidacji poszczególnych pól.
messageTekstWymaganeOpis przeznaczony dla człowieka; w logice programu używaj kodu błędu.
Dodatkowe pola: Nie
Utwórz markę — Odpowiedź
ApiResponse_MutationData_ · Pola, typy i ograniczenia danych przyjmowanych lub zwracanych przez API.
dataMutationDataWymaganePrzykład odpowiedzi · MutationData.
metaContextPageMetaContextMetaPageMetaRequestMetaWymaganeMetadane odpowiedzi.
Dodatkowe pola: Nie
Metadane odpowiedzi
ContextMeta · Schemat · Wspólne modele danych
localeTekstWymaganeJęzyk wybrany dla tego żądania.
market_codeTekstWymaganeKod rynku zwrócony przez endpoint kontekstu.
market_idTekstWymaganeIdentyfikator rynku zwrócony przez endpoint kontekstu.
request_idTekstWymaganeIdentyfikator zgłoszenia; w metadanych odpowiedzi identyfikuje żądanie HTTP.
minLength:1maxLength:100
Dodatkowe pola: Nie
Metadane odpowiedzi
ContextPageMeta · Schemat · Wspólne modele danych
localeTekstWymaganeJęzyk wybrany dla tego żądania.
market_codeTekstWymaganeKod rynku zwrócony przez endpoint kontekstu.
market_idTekstWymaganeIdentyfikator rynku zwrócony przez endpoint kontekstu.
paginationPaginationWymaganeMetadane stronicowania z użyciem kursora.
request_idTekstWymaganeIdentyfikator zgłoszenia; w metadanych odpowiedzi identyfikuje żądanie HTTP.
minLength:1maxLength:100
Dodatkowe pola: Nie
Katalog błędów
ErrorResponse · Pola, typy i ograniczenia danych przyjmowanych lub zwracanych przez API.
errorApiErrorWymaganeUstrukturyzowane informacje o błędzie.
metaRequestMetaWymaganeMetadane odpowiedzi.
Dodatkowe pola: Nie
Błędy walidacji poszczególnych pól
FieldError · Schemat · Wspólne modele danych
codeTekstWymaganeStały kod przeznaczony do przetwarzania przez integrację.
Ograniczenia
enum["required", "invalid_type", "invalid_value", "out_of_range", "unknown_field", "invalid_format", "invalid_cursor", "unsupported_value"]
fieldTekstWymaganePole powiązane z błędem walidacji.
minLength:1maxLength:128locationTekstWymaganeInformacje o lokalizacji.
Ograniczenia
enum["path", "query", "header", "body"]
Dodatkowe pola: Nie
Kwota przed dodatkowymi składnikami pokazanymi w odpowiedzi
MoneyData · Schemat · Wspólne modele danych
amountTekstWymaganeKwota dziesiętna zapisana jako tekst JSON; null tylko tam, gdzie jest dozwolony.
currencyTekstWymaganeKod waluty kwoty.
Ograniczenia
pattern"^[A-Z]{3}$"
minor_unitsLiczba całkowitaWymaganeLiczba cyfr części ułamkowej używanych przez walutę.
minimum:0maximum:4
Dodatkowe pola: Nie
Utwórz markę — Odpowiedź
MutationData · Pola, typy i ograniczenia danych przyjmowanych lub zwracanych przez API.
deletedWartość logicznaWymaganeCzy zastosowano usunięcie.
idTekstWymaganeIdentyfikator zasobu; zachowaj wartość zwróconą przez API. (MutationData).
versionLiczba całkowita nullWymaganeWersja zasobu używana do kontroli współbieżności.
Dodatkowe pola: Nie
Metadane odpowiedzi
PageMeta · Schemat · Wspólne modele danych
paginationPaginationWymaganeMetadane stronicowania z użyciem kursora.
request_idTekstWymaganeIdentyfikator zgłoszenia; w metadanych odpowiedzi identyfikuje żądanie HTTP.
minLength:1maxLength:100
Dodatkowe pola: Nie
Metadane stronicowania z użyciem kursora
Pagination · Schemat · Wspólne modele danych
has_moreWartość logicznaWymaganeCzy dostępna jest kolejna strona.
limitLiczba całkowitaWymaganeMaksymalna liczba rekordów na tej stronie.
minimum:1maximum:100next_cursorTekst nullWymaganeZnacznik kontynuacji dla następnej strony albo null.
Dodatkowe pola: Nie
Metadane odpowiedzi
RequestMeta · Schemat · Wspólne modele danych
request_idTekstWymaganeIdentyfikator zgłoszenia; w metadanych odpowiedzi identyfikuje żądanie HTTP.
minLength:1maxLength:100
Dodatkowe pola: Nie