Personas

Create person

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.

Cuerpo de la solicitud

application/json

body

full_name*string

Trimmed Unicode full name.

Longitud1 <= length <= 255

email*string

Coincidencia

^[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*@[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?)+$

Formatoemail

Longitudlength <= 254

phone_number*string

National digits preserving leading zeros. Combined dialing prefix and national digits must match ^+[1-9][0-9]{1,14}$.

Coincidencia^[0-9]+$

Longitud1 <= length <= 14

country_code*string

Telephone dialing prefix, never an ISO country identifier.

Coincidencia^\+[1-9][0-9]{0,2}$

Cuerpo de la respuesta

Person created

application/json

response

id*string

Formatouuid

full_name*string

Trimmed Unicode full name.

Longitud1 <= length <= 255

email*string

Coincidencia

^[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[A-Za-z0-9!#$%&'*+/=?^_`{|}~-]+)*@[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?(?:\.[A-Za-z0-9](?:[A-Za-z0-9-]*[A-Za-z0-9])?)+$

Formatoemail

Longitudlength <= 254

phone_number*string

National digits preserving leading zeros. Combined dialing prefix and national digits must match ^+[1-9][0-9]{1,14}$.

Coincidencia^[0-9]+$

Longitud1 <= length <= 14

country_code*string

Telephone dialing prefix, never an ISO country identifier.

Coincidencia^\+[1-9][0-9]{0,2}$

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 POST 'https://api.centrixiso.com/persons' \
  -H 'Content-Type: application/json' \
  -d '{
  "full_name": "Alex Morgan",
  "email": "alex.morgan@example.com",
  "phone_number": "2025550123",
  "country_code": "+1"
}'

cURL

curl -X POST 'https://api.centrixiso.com/persons' \  -H 'Content-Type: application/json' \  -d '{  "full_name": "Alex Morgan",  "email": "alex.morgan@example.com",  "phone_number": "2025550123",  "country_code": "+1"}'

Respuesta de ejemploEsquema

{
  "id": "8b7f8b7d-3ac0-4ce2-b85f-578f3113022d",
  "full_name": "Alex Morgan",
  "email": "alex.morgan@example.com",
  "phone_number": "2025550123",
  "country_code": "+1"
}

{  "id": "8b7f8b7d-3ac0-4ce2-b85f-578f3113022d",  "full_name": "Alex Morgan",  "email": "alex.morgan@example.com",  "phone_number": "2025550123",  "country_code": "+1"}

Detalles del protocolo

ID de operación: createPerson
Método y ruta: POST /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
Cabecera	Requisito	Esquema
`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
Estado	Cabecera	Esquema
`201`	`Cache-Control`	`{"type":"string"}` Ejemplo: `"no-store"`
`201`	`Location`	`{"type":"string"}` Ejemplo: `"/persons/8b7f8b7d-3ac0-4ce2-b85f-578f3113022d"`
`201`	`API-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"`
`201`	`Vary` Business responses vary on API-Version, preserving existing values such as Origin for CORS.	`{"type":"string"}` Ejemplo: `"API-Version"`
`400`	`Cache-Control`	`{"type":"string"}` Ejemplo: `"no-store"`
`400`	`API-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"`
`400`	`Vary` Business responses vary on API-Version, preserving existing values such as Origin for CORS.	`{"type":"string"}` Ejemplo: `"API-Version"`
`405`	`Cache-Control`	`{"type":"string"}` Ejemplo: `"no-store"`
`405`	`Allow`	`{"type":"string"}` Ejemplo: `"GET, HEAD, POST"`
`405`	`API-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"`
`405`	`Vary` Business responses vary on API-Version, preserving existing values such as Origin for CORS.	`{"type":"string"}` Ejemplo: `"API-Version"`
`406`	`Cache-Control`	`{"type":"string"}` Ejemplo: `"no-store"`
`406`	`API-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"`
`406`	`Vary` Business responses vary on API-Version, preserving existing values such as Origin for CORS.	`{"type":"string"}` Ejemplo: `"API-Version"`
`415`	`Cache-Control`	`{"type":"string"}` Ejemplo: `"no-store"`
`415`	`API-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"`
`415`	`Vary` Business responses vary on API-Version, preserving existing values such as Origin for CORS.	`{"type":"string"}` Ejemplo: `"API-Version"`
`500`	`Cache-Control`	`{"type":"string"}` Ejemplo: `"no-store"`
`500`	`API-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"`
`500`	`Vary` Business responses vary on API-Version, preserving existing values such as Origin for CORS.	`{"type":"string"}` Ejemplo: `"API-Version"`
`503`	`Cache-Control`	`{"type":"string"}` Ejemplo: `"no-store"`
`503`	`API-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"`
`503`	`Vary` Business responses vary on API-Version, preserving existing values such as Origin for CORS.	`{"type":"string"}` Ejemplo: `"API-Version"`

El objeto Persona

Esquema y operaciones del recurso Personas.

Actualizar una persona

Página siguiente

Create person

Parámetros de encabezadoCopiar enlace

Cuerpo de la solicitudCopiar enlace

Cuerpo de la respuestaCopiar enlace

Ejemplos de solicitud

Detalles del protocolo

Cabeceras de solicitud

Parámetros de encabezado

Cuerpo de la solicitud

Cuerpo de la respuesta