Package dev.dosya.sdk.exception

Class DosyaApiException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

dev.dosya.sdk.exception.DosyaException

dev.dosya.sdk.exception.DosyaApiException

All Implemented Interfaces:

Serializable

public final class DosyaApiException
extends DosyaException

Thrown when the Dosya API returns an error response.

Carries structured context: HTTP status code, error message from the API, raw response body, and server request ID (if available).

Since:

0.1.0

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
DosyaApiException(int status, String errorMessage)
DosyaApiException(int status, String errorMessage, @Nullable String raw)
DosyaApiException(int status, String errorMessage, @Nullable String raw, @Nullable String requestId)
DosyaApiException(int status, String errorMessage, @Nullable String raw, @Nullable String requestId, @Nullable Throwable cause)

Method Summary

Modifier and Type	Method	Description
String	getErrorMessage()	Returns the error message from the API.
@Nullable String	getRaw()	Returns the raw response body, or null.
@Nullable String	getRequestId()	Returns the server request ID from the X-Request-Id header, or null.
int	getStatus()	Returns the HTTP status code.

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Details

DosyaApiException

public DosyaApiException(int status,
 String errorMessage)

DosyaApiException

public DosyaApiException(int status,
 String errorMessage,
 @Nullable
 @Nullable String raw)

DosyaApiException

public DosyaApiException(int status,
 String errorMessage,
 @Nullable
 @Nullable String raw,
 @Nullable
 @Nullable String requestId)

DosyaApiException

public DosyaApiException(int status,
 String errorMessage,
 @Nullable
 @Nullable String raw,
 @Nullable
 @Nullable String requestId,
 @Nullable
 @Nullable Throwable cause)

Method Details

getStatus

public int getStatus()

Returns the HTTP status code.

getErrorMessage

public String getErrorMessage()

Returns the error message from the API.

getRaw

@Nullable
public @Nullable String getRaw()

Returns the raw response body, or null.

getRequestId

@Nullable
public @Nullable String getRequestId()

Returns the server request ID from the X-Request-Id header, or null.