Struct ApiJson 

pub struct ApiJson<T>(pub T);

A drop-in replacement for axum::Json whose extraction failures reject with an ApiError JSON body instead of Axum’s default plain-text response.

As an extractor it deserializes the request body exactly like axum::Json, but on failure it short-circuits the handler with (StatusCode, Json<ApiError>):

• malformed JSON -> 400 Bad Request, code INVALID_JSON
• well-formed JSON of the wrong shape -> 422 Unprocessable Entity, code INVALID_BODY
• missing or incorrect Content-Type -> 415 Unsupported Media Type, code UNSUPPORTED_MEDIA_TYPE

The HTTP status is taken from Axum’s own rejection, so it stays correct as Axum evolves. It also implements IntoResponse (serializing as 200 OK JSON), so it can be used as a handler return type just like axum::Json.

Unlike ValidatedJson, ApiJson performs no validation and so needs only the extract feature, not validator. Reach for ValidatedJson when you want validator-based field validation as well.

Requires the extract feature.

Example

use axum_api_kit::ApiJson;
use serde::Deserialize;

#[derive(Deserialize)]
struct CreateUser {
    name: String,
}

// The body is deserialized before the handler runs; bad input becomes an ApiError body.
async fn create_user(ApiJson(user): ApiJson<CreateUser>) {
    let _ = user.name;
}

Tuple Fields

0: T

Trait Implementations

impl<T: Clone> Clone for ApiJson<T>

fn clone(&self) -> ApiJson<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for ApiJson<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<T, S> FromRequest<S> for ApiJson<T>

where T: DeserializeOwned, S: Send + Sync,

type Rejection = (StatusCode, Json<ApiError>)

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request(req: Request, state: &S) -> Result<Self, Self::Rejection>

Perform the extraction.

impl<T: Serialize> IntoResponse for ApiJson<T>

fn into_response(self) -> Response

Create a response.