Saltar al contenido
Centrix Developers
DocumentaciónReferencia de API
Personas

List persons

Versión de API 0.0.1
Acceso público
No se requiere iniciar sesión. Los registros son compartidos y cualquier visitante puede modificarlos.
limit?integer
Intervalo1 <= value <= 100
Predeterminado25
offset?integer
Intervalo0 <= value <= 2147483647
Predeterminado0
API-Version?string

Omit this header or send latest to select the latest supported API version (currently 0.0.1). Send 0.0.1 to pin this contract. Values are case-sensitive after trimming. Empty, unsupported, comma-combined or repeated headers return 400 before handlers; invalid versions never fall back.

Predeterminado"latest"
Valor en"latest""0.0.1"

Cuerpo de la respuesta

Page ordered by UUID ascending

application/json
  1. response
items*array<>
limit*integer
Intervalo1 <= value <= 100
offset*integer
Intervalo0 <= value
has_more*boolean

Ejemplos de solicitud

Elige un lenguaje y copia la solicitud para ejecutarla en tu equipo. Usa el playground para enviar una solicitud desde esta página. Las cabeceras de versión que edites allí también actualizan estos ejemplos.

cURL
curl -X GET 'https://api.centrixiso.com/persons'
Respuesta de ejemplo
{  "items": [    {      "id": "8b7f8b7d-3ac0-4ce2-b85f-578f3113022d",      "full_name": "Alex Morgan",      "email": "alex.morgan@example.com",      "phone_number": "2025550123",      "country_code": "+1"    }  ],  "limit": 25,  "offset": 0,  "has_more": false}

Detalles del protocolo

ID de operación
listPersons
Método y ruta
GET /persons
Acceso
Público; no requiere autenticación.

Los parámetros, campos obligatorios, restricciones de validación, esquemas de respuesta y ejemplos de error se generan a partir del contrato del backend. Las tablas muestran las cabeceras de solicitud y respuesta declaradas para esta operación.

Consultar la especificación OpenAPI 3.1 completa

Cabeceras de solicitud

Omite una cabecera opcional para usar el valor predeterminado de su esquema. Para fijar una versión de API, abre el explorador y configura su cabecera de versión. Los cambios actualizan los ejemplos de los lenguajes, que puedes copiar y ejecutar en tu equipo.

Cabeceras de solicitud
CabeceraRequisitoEsquema
API-Version

Omit this header or send latest to select the latest supported API version (currently 0.0.1). Send 0.0.1 to pin this contract. Values are case-sensitive after trimming. Empty, unsupported, comma-combined or repeated headers return 400 before handlers; invalid versions never fall back.

Opcional{"type":"string","enum":["latest","0.0.1"],"default":"latest"}
Cabeceras de respuesta por estado HTTP
EstadoCabeceraEsquema
200Cache-Control{"type":"string"}

Ejemplo: "no-store"

200API-Version

Resolved API version for business requests. Present on success and operation errors after successful negotiation; absent when API-Version is invalid.

{"type":"string","enum":["0.0.1"]}

Ejemplo: "0.0.1"

200Vary

Business responses vary on API-Version, preserving existing values such as Origin for CORS.

{"type":"string"}

Ejemplo: "API-Version"

400Cache-Control{"type":"string"}

Ejemplo: "no-store"

400API-Version

Resolved API version for business requests. Present on success and operation errors after successful negotiation; absent when API-Version is invalid.

{"type":"string","enum":["0.0.1"]}

Ejemplo: "0.0.1"

400Vary

Business responses vary on API-Version, preserving existing values such as Origin for CORS.

{"type":"string"}

Ejemplo: "API-Version"

405Cache-Control{"type":"string"}

Ejemplo: "no-store"

405Allow{"type":"string"}

Ejemplo: "GET, HEAD, POST"

405API-Version

Resolved API version for business requests. Present on success and operation errors after successful negotiation; absent when API-Version is invalid.

{"type":"string","enum":["0.0.1"]}

Ejemplo: "0.0.1"

405Vary

Business responses vary on API-Version, preserving existing values such as Origin for CORS.

{"type":"string"}

Ejemplo: "API-Version"

406Cache-Control{"type":"string"}

Ejemplo: "no-store"

406API-Version

Resolved API version for business requests. Present on success and operation errors after successful negotiation; absent when API-Version is invalid.

{"type":"string","enum":["0.0.1"]}

Ejemplo: "0.0.1"

406Vary

Business responses vary on API-Version, preserving existing values such as Origin for CORS.

{"type":"string"}

Ejemplo: "API-Version"

415Cache-Control{"type":"string"}

Ejemplo: "no-store"

415API-Version

Resolved API version for business requests. Present on success and operation errors after successful negotiation; absent when API-Version is invalid.

{"type":"string","enum":["0.0.1"]}

Ejemplo: "0.0.1"

415Vary

Business responses vary on API-Version, preserving existing values such as Origin for CORS.

{"type":"string"}

Ejemplo: "API-Version"

500Cache-Control{"type":"string"}

Ejemplo: "no-store"

500API-Version

Resolved API version for business requests. Present on success and operation errors after successful negotiation; absent when API-Version is invalid.

{"type":"string","enum":["0.0.1"]}

Ejemplo: "0.0.1"

500Vary

Business responses vary on API-Version, preserving existing values such as Origin for CORS.

{"type":"string"}

Ejemplo: "API-Version"

503Cache-Control{"type":"string"}

Ejemplo: "no-store"

503API-Version

Resolved API version for business requests. Present on success and operation errors after successful negotiation; absent when API-Version is invalid.

{"type":"string","enum":["0.0.1"]}

Ejemplo: "0.0.1"

503Vary

Business responses vary on API-Version, preserving existing values such as Origin for CORS.

{"type":"string"}

Ejemplo: "API-Version"