El objeto Persona

Una Persona es un recurso independiente del núcleo que representa a un individuo y sus datos de contacto.

El recurso Personas pertenece a la versión 0.0.1 de la API pública y usa /persons. Selecciona una operación para consultar su método HTTP, los parámetros, los esquemas de solicitud y respuesta, los códigos de estado, las cabeceras y los ejemplos.

Omite la cabecera opcional API-Version, o envía API-Version: latest, para seguir la última versión del servidor, actualmente 0.0.1. Envía API-Version: 0.0.1 para fijar explícitamente la solicitud. La respuesta indica la versión resuelta en API-Version. Las versiones no compatibles devuelven 400 sin modificar datos ni recurrir a otra versión.

Sigue la guía de Personas para conocer la validación de campos, los códigos de marcación, la paginación y el recorrido completo con curl. La política de versiones de la API se aplica a toda la API pública, incluido este recurso.

Abre una operación de abajo y usa Probar en el explorador para enviar una solicitud desde el navegador. En esa página de operación, elige cURL, JavaScript, Python, Java, Go, C# o Rust en Ejemplos de solicitud para copiar un ejemplo y ejecutarlo localmente. Actualizar usa PUT y requiere los cuatro campos editables; reemplaza el contacto completo.

Acceso públicoCopiar enlace

Las solicitudes a Personas no requieren iniciar sesión. Los registros se comparten con la consola y cualquier visitante puede modificarlos.

Esquema del objetoCopiar enlace

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

{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "id",
    "full_name",
    "email",
    "phone_number",
    "country_code"
  ],
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid",
      "readOnly": true
    },
    "full_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Trimmed Unicode full name."
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 254,
      "pattern": "^[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])?)+$"
    },
    "phone_number": {
      "type": "string",
      "pattern": "^[0-9]+$",
      "minLength": 1,
      "maxLength": 14,
      "description": "National digits preserving leading zeros. Combined dialing prefix and national digits must match ^\\+[1-9][0-9]{1,14}$."
    },
    "country_code": {
      "type": "string",
      "pattern": "^\\+[1-9][0-9]{0,2}$",
      "description": "Telephone dialing prefix, never an ISO country identifier."
    }
  }
}

OperacionesCopiar enlace