Skip to content

Models Reference

Reference for request and response models used throughout Apiary.

Response Models

models.responses

Response models for API endpoints.

BaseResponse

Bases: BaseModel

Base response model.

ErrorResponse

Bases: BaseModel

Standard error response model.

BaseDataResponse

Bases: BaseResponse

Base response for data endpoints.

CryptoPriceResponse

Bases: BaseDataResponse

Response model for cryptocurrency price endpoint.

BaseCombinedResponse

Bases: BaseDataResponse

Base response for combined data endpoints.

Request Models

models.requests

Request models for API endpoints.

HealthCheckQuery

Bases: BaseModel

Query parameters for health check endpoints.

Usage Examples

Using Response Models

from models.responses import BaseResponse

class MyResponse(BaseResponse):
    """Custom response model."""
    data: dict
    count: int

# All responses automatically include timestamp
response = MyResponse(data={"key": "value"}, count=1)

Using Request Models

from pydantic import BaseModel

class QueryParams(BaseModel):
    """Query parameters for endpoint."""
    name: str
    limit: int = 10

@router.get("/items")
async def get_items(params: QueryParams = Depends()):
    return {"items": []}

Next Steps