{
    "openapi": "3.0.0",
    "info": {
        "title": "API Docs",
        "description": "API Documentation",
        "version": "1.0"
    },
    "servers": [
        {
            "url": "http://127.0.0.1:8000/api/"
        }
    ],
    "paths": {
        "/clientes": {
            "get": {
                "tags": [
                    "Clientes"
                ],
                "summary": "Obtener una lista de clientes",
                "operationId": "ce1b06de9bbd15a5cc0ed7ab28ee5713",
                "parameters": [
                    {
                        "name": "search",
                        "in": "query",
                        "description": "Filtrar por nombre o ID",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "param",
                        "in": "query",
                        "description": "Columna para ordenar",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    },
                    {
                        "name": "order",
                        "in": "query",
                        "description": "Orden de clasificación (asc o desc)",
                        "required": false,
                        "schema": {
                            "type": "string"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "Lista de clientes",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "array",
                                    "items": {
                                        "$ref": "#/components/schemas/ClienteResource"
                                    }
                                }
                            }
                        }
                    },
                    "400": {
                        "description": "Solicitud incorrecta"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "Cliente": {
                "title": "Cliente",
                "properties": {
                    "id": {
                        "type": "integer",
                        "example": 1
                    },
                    "nombre": {
                        "type": "string",
                        "example": "Jhon Doe"
                    },
                    "regimen_fiscal": {
                        "type": "string",
                        "example": "Servicios Profesionales"
                    },
                    "rfc": {
                        "type": "string",
                        "example": "TEA621018U58"
                    },
                    "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2023-02-23T00:09:16.000000Z"
                    },
                    "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2023-02-23T12:33:45.000000Z"
                    }
                },
                "type": "object"
            },
            "ClienteResource": {
                "title": "Cliente Resource",
                "properties": {
                    "data": {
                        "$ref": "#/components/schemas/Cliente"
                    }
                },
                "type": "object"
            }
        }
    },
    "tags": [
        {
            "name": "Clientes",
            "description": "Clientes"
        }
    ]
}