Formatear Respuesta de API JSON

Respuesta Formateada

Aplicar un formateador a la entrada minificada produce:

{
  "status": "success",
  "data": {
    "users": [
      {
        "id": 1,
        "name": "Alice Chen",
        "email": "alice@example.com",
        "role": "admin",
        "created_at": "2024-01-15T08:30:00Z"
      },
      {
        "id": 2,
        "name": "Bob Martinez",
        "email": "bob@example.com",
        "role": "editor",
        "created_at": "2024-03-22T14:15:00Z"
      },
      {
        "id": 3,
        "name": "Carol Williams",
        "email": "carol@example.com",
        "role": "viewer",
        "created_at": "2024-06-10T11:45:00Z"
      }
    ],
    "total": 3,
    "page": 1,
    "per_page": 25
  },
  "meta": {
    "request_id": "req_abc123",
    "response_time_ms": 42
  }
}

La estructura es inmediatamente legible: un envoltorio de éxito que contiene una lista paginada de usuarios más metadatos de la solicitud.

Por Que el JSON Formateado Importa para la Depuración

Cuándo usas curl para consultar una API y recibes un muro de JSON minificado, lo primero que haces es pasarlo por un formateador. La razon es práctica: las estructuras anidadas son invisibles en una sola línea. Sin indentación, no puedes escanear una clave faltante, notar un valor null o verificar la longitud de un arreglo.

El JSON formateado hace que varias tareas de depuración sean mucho más rápidas:

• Encontrar campos null o faltantes inesperados. Cuándo cada clave está en su propia línea, un campo faltante resalta inmediatamente en lugar de estar oculto dentro de un string largo.
• Verificar la anidación. En forma minificada, el JSON profundamente anidado requiere contar llaves y paréntesis manualmente. La indentación hace que la estructura de árbol sea visible al instante.
• Hacer diff de respuestas. Dos blobs JSON minificados se muestran como una sola línea modificada aunque solo haya cambiado un campo. Con el formato bonito puedes ver exactamente que campo cambio.