Admin Search Endpoints — Responsables and Ubicaciones

The admin dashboard provides two search endpoints — one for searching responsible persons and one for searching locations — both requiring a valid JWT token.

Search Responsables
Search Locations

GET /api/admin/responsables/buscar

Search for responsible persons by partial name match.

Method: GET
Path: /api/admin/responsables/buscar
Auth: Bearer JWT

Query Parameters

string

required

Partial name to search for. An empty string returns an empty array [].

Request Example

curl "http://localhost:5000/api/admin/responsables/buscar?q=Lopez" \
  -H "Authorization: Bearer <token>"

Response (200)

Returns an array of matching responsible-person objects.

[{ "id": 1, "name": "Lopez Corrales Andres" }]

integer

Primary key of the responsible person.

name

string

Full name of the responsible person.

GET /api/admin/ubicaciones/buscar

Search for locations by partial number or description match.

Method: GET
Path: /api/admin/ubicaciones/buscar
Auth: Bearer JWT

Query Parameters

string

required

Partial number or description to search for. Matches against both the number_location and description columns using a SQL LIKE %query% pattern. An empty string returns an empty array [].

Request Example

curl "http://localhost:5000/api/admin/ubicaciones/buscar?q=104" \
  -H "Authorization: Bearer <token>"

Response (200)

Returns an array of location objects serialised via Location.to_dict() — the same shape as entries in the public /api/ubicaciones response.

[{
  "id_location": 3,
  "id_responsible": 1,
  "number_location": 104,
  "description": "Laboratorio de Materiales",
  "last_revision_date": "2024-11-15T10:30:00",
  "last_revision": {
    "id": 7,
    "id_location": 3,
    "date_time_revision": "2024-11-15T10:30:00",
    "comment": "Todo en orden"
  }
}]

id_location

integer

Primary key of the location.

id_responsible

integer

Foreign key referencing the responsible person assigned to this location.

number_location

integer

Numeric identifier used to label the physical location.

description

string

Human-readable name or description of the location (e.g. "Laboratorio de Materiales").

last_revision_date

string

ISO 8601 timestamp of the most recent revision for this location. null if no revision has been recorded yet.

last_revision

object

Full revision object for the most recent revision, or null if none exists.

Show last_revision fields

integer

Primary key of the revision record.

id_location

integer

Foreign key back to the location.

date_time_revision

string

ISO 8601 timestamp when the revision was recorded.

comment

string

Free-text comment left by the inspector. May be null.

Overview

Public Endpoints

Admin Endpoints

Admin Search Endpoints — Responsables and Ubicaciones

GET /api/admin/responsables/buscar

Query Parameters

Request Example

Response (200)

GET /api/admin/ubicaciones/buscar

Query Parameters

Request Example

Response (200)

Build docs developers (and LLMs) love

Overview

Public Endpoints

Admin Endpoints

Documentation Index

​GET /api/admin/responsables/buscar

​Query Parameters

​Request Example

​Response (200)

​GET /api/admin/ubicaciones/buscar

​Query Parameters

​Request Example

​Response (200)

Build docs developers (and LLMs) love

GET /api/admin/responsables/buscar

Query Parameters

Request Example

Response (200)

GET /api/admin/ubicaciones/buscar

Query Parameters

Request Example

Response (200)