Reference — Errors

public record LolApiError(int status, String code, String message, ResponseMetadata metadata) {
    public LolApiError(int status, String code, String message) { this(status, code, message, null); }
}

{
  "status": 202,
  "code": "profile_pending",
  "message": "Profile initialization is pending",
  "metadata": {
    "pagination": null,
    "lastUpdate": null,
    "refresh": true,
    "filter": null
  }
}

private String codeFor(HttpStatusCode status) {
    return switch (status.value()) {
        case 400 -> "invalid_request";
        case 404 -> "not_found";
        case 405 -> "method_not_allowed";
        default -> "request_failed";
    };
}

// LolApiParameters.java:235
public static ResponseStatusException invalid(String parameter, String reason) {
    return new ResponseStatusException(HttpStatus.BAD_REQUEST, "Invalid " + parameter + ": " + reason);
}

case PENDING -> ResponseEntity.status(HttpStatus.ACCEPTED)
    .body(new LolApiError(HttpStatus.ACCEPTED.value(), pendingCode, pendingMessage, result.metadata()));

HTTP/1.1 202 Accepted
Content-Type: application/json
X-Profile-Refresh: true

{
  "status": 202,
  "code": "profile_activity_pending",
  "message": "Profile activity is being prepared",
  "metadata": { "lastUpdate": 1715434800000, "refresh": true, "filter": { "champion": 157 } }
}

private ResponseEntity<LolApiError> error(HttpStatusCode status, String code, String message) {
    String errorMessage = message != null && !message.isBlank() ? message : HttpStatus.valueOf(status.value()).getReasonPhrase();
    return ResponseEntity.status(status).body(new LolApiError(status.value(), code, errorMessage));
}

{
  "status": 400,
  "code": "invalid_request",
  "message": "Invalid patch: must have the form major.minor",
  "metadata": null
}

{
  "status": 400,
  "code": "invalid_request",
  "message": "Invalid limit: must be between 1 and 50",
  "metadata": null
}

{
  "status": 404,
  "code": "not_found",
  "message": "Profile not found",
  "metadata": null
}

{
  "status": 404,
  "code": "not_found",
  "message": "Endpoint not found",
  "metadata": null
}

{
  "status": 405,
  "code": "method_not_allowed",
  "message": "HTTP method 'POST' is not supported for this endpoint",
  "metadata": null
}

{
  "status": 202,
  "code": "match_pending",
  "message": "Match analysis is pending",
  "metadata": { "lastUpdate": null, "refresh": true, "filter": null }
}

{
  "status": 500,
  "code": "internal_error",
  "message": "Unexpected server error",
  "metadata": null
}

async function callApi(url) {
  const res = await fetch(url);
  if (res.status === 202) {
    const err = await res.json(); // LolApiError with code *_pending
    console.log("pending:", err.code, err.metadata);
    return { pending: true, err };
  }
  if (res.status === 400) {
    const err = await res.json();
    throw new Error(`Bad request: ${err.message} (${err.code})`);
  }
  if (res.status === 404) throw new Error("Not found");
  if (res.status === 405) throw new Error("Method not allowed");
  if (!res.ok) throw new Error(`HTTP ${res.status}`);
  return { pending: false, data: await res.json() };
}