Personas¶

Tabla normalizada de personas del padrón CDMX.

Namespace¶

datos_mexico.endpoints.personas.PersonasNamespace ¶

PersonasNamespace(http: HttpClient)

Bases: BaseNamespace

Endpoints de la tabla normalizada personas del padrón CDMX.

Una persona es la entidad atómica del padrón: nombre, apellidos, sexo, edad. Para acceder al sueldo y al puesto hay que seguir la relación a nombramientos (una persona puede tener varios nombramientos, p. ej. con doble plaza).

Para el caso común de "ver al servidor con sus campos derivados ya aplanados" suele ser más útil client.cdmx.servidores_lista() o client.cdmx.servidor_detail(id), que devuelven la vista desnormalizada lista para consumir.

list ¶

list(
    *,
    page: int = 1,
    per_page: int = 50,
    nombre: str | None = None,
    sexo_id: int | None = None,
) -> PaginatedResponse[Persona]

Lista paginada de personas del padrón.

Endpoint: GET /api/v1/personas/

Parameters:

Name	Type	Description	Default
`page`	`int`	Número de página (1-indexed).	`1`
`per_page`	`int`	Elementos por página.	`50`
`nombre`	`str \| None`	Filtro por nombre (búsqueda parcial).	`None`
`sexo_id`	`int \| None`	Filtro por ID de sexo. Ver `client.cdmx.catalogo_sexos()` para la lista de IDs.	`None`

get ¶

get(persona_id: int) -> Persona

Detalle de una persona por ID.

Endpoint: GET /api/v1/personas/{persona_id}

Raises:

Type	Description
`NotFoundError`	Si no existe una persona con ese ID.

Modelo¶

Modelos Pydantic del namespace personas.

Tabla normalizada del Patrón Único de Servidores Públicos CDMX. Cada persona es un registro único independientemente del puesto (un servidor con doble plaza tendría una sola persona y dos nombramientos).

Persona ¶

Bases: DatosMexicoModel

Item de GET /api/v1/personas/ y GET /api/v1/personas/{id}.

El campo apellido_2 puede no estar presente para personas con un solo apellido. sexo_id y edad pueden ser None cuando el dato fuente venía sin esa información.