Documentación API

Accede a 168 principios UX/UI respaldados por investigación de forma programática. Construye herramientas, integraciones y flujos de trabajo.

URL Basehttps://uxuiprinciples.com/api/v1

Autenticación

Todas las solicitudes requieren una clave API. Inclúyela en los headers.

Header Authorization (recomendado)

curl -X GET "https://uxuiprinciples.com/api/v1/principles" \
  -H "Authorization: Bearer uxui_live_your_key_here"

Header X-API-Key

curl -X GET "https://uxuiprinciples.com/api/v1/principles" \
  -H "X-API-Key: uxui_live_your_key_here"

Las solicitudes sin clave API reciben acceso gratuito (limitado a 12 principios).

Obtener Clave API

Límites de Tasa

Los límites se aplican por dirección IP, reiniciándose cada hora.

NivelLímite

Gratis100 solicitudes/hora

ProPro1,000 solicitudes/hora

Cuando se excede el límite, las respuestas incluyen el header Retry-After.

Endpoints

GET/principles

Obtiene principios UX/UI con filtrado opcional.

Query Parameters

localeCódigo de idioma (en, es)

slugObtener principio específico por slug

partFiltrar por parte (ej., part-1)

difficultyFiltrar por dificultad (beginner, intermediate, advanced)

searchBuscar en título, slug y etiquetas

include_contentIncluir contenido MDX completo (Solo Pro)

Example

curl "https://uxuiprinciples.com/api/v1/principles?locale=en&part=part-1"

GET/smellsPro

Obtiene anti-patrones UX y sus soluciones.

Query Parameters

localeCódigo de idioma (en, es)

categoryFiltrar por categoría

searchBuscar en títulos y descripciones

Example

curl "https://uxuiprinciples.com/api/v1/smells?locale=en" \
  -H "Authorization: Bearer uxui_live_your_key_here"

GET/flowsPro

Obtiene checklists de flujos de usuario con items pre-flight y post-flight.

Query Parameters

localeCódigo de idioma (en, es)

slugObtener flujo específico por slug

Example

curl "https://uxuiprinciples.com/api/v1/flows?locale=en" \
  -H "Authorization: Bearer uxui_live_your_key_here"

Formato de Respuesta

Todas las respuestas siguen una estructura JSON consistente.

Respuesta Exitosa

{
  "success": true,
  "data": [
    {
      "slug": "chunking",
      "title": "Chunking",
      "code": "F.1.1.01",
      "part": "part-1",
      "partName": "Foundations",
      "difficulty": "beginner",
      "readTime": 4,
      "aiSummary": "Miller's Law demonstrates...",
      "tags": ["cognitive-load", "memory"]
    }
  ],
  "meta": {
    "timestamp": "2026-01-17T12:00:00.000Z",
    "version": "v1",
    "tier": "pro",
    "count": 168,
    "total": 168
  }
}

Respuesta de Error

{
  "success": false,
  "error": {
    "message": "Invalid API key",
    "code": "AUTH_FAILED",
    "status": 401
  },
  "meta": {
    "timestamp": "2026-01-17T12:00:00.000Z",
    "version": "v1"
  }
}

Códigos de Error

Códigos de error estándar devueltos por la API.

400Bad Request - Parámetros inválidos

401Unauthorized - Clave API inválida o faltante

403Forbidden - Se requiere nivel Pro

404Not Found - El recurso no existe

429Rate Limited - Demasiadas solicitudes

500Server Error - Intenta más tarde

También Disponible

MCP Server

¿Prefieres trabajar con Claude directamente? Usa nuestro MCP Server para acceder a principios UX en conversaciones con Claude Code y Claude Desktop.

Ver Documentación MCP

¿Listo para integrar?

Obtén tu clave API y comienza a construir con 168 principios respaldados por investigación.

Obtener Acceso API

$19/año • O consigue el Developer Bundle con MCP Server por $29/año

{ "success": true, "data": [ { "slug": "chunking", "title": "Chunking", "code": "F.1.1.01", "part": "part-1", "partName": "Foundations", "difficulty": "beginner", "readTime": 4, "aiSummary": "Miller's Law demonstrates...", "tags": ["cognitive-load", "memory"] } ], "meta": { "timestamp": "2026-01-17T12:00:00.000Z", "version": "v1", "tier": "pro", "count": 168, "total": 168 } }

{ "success": false, "error": { "message": "Invalid API key", "code": "AUTH_FAILED", "status": 401 }, "meta": { "timestamp": "2026-01-17T12:00:00.000Z", "version": "v1" } }