Solución de Problemas API

Códigos de Error de la API

Problema: Error 403 — Sin Permisos

Síntomas:

{
  "code": 403,
  "error": "Sin permisos para acceder a este proceso"
}

Causas posibles:

• El usuario no tiene perfil "API"
• El proceso está asignado a otro usuario API
• SessionToken no enviado en los headers

Solución:

1. Verificar que el usuario tiene perfil API en el panel de administración
2. Verificar que el proceso está asignado a este usuario API
3. Incluir X-Parse-Session-Token en los headers

Problema: Error 404 — Proceso No Encontrado

Síntomas:

{
  "code": 404,
  "error": "Proceso no encontrado"
}

Causa: El ID del proceso es incorrecto o el proceso fue eliminado.

Solución:

1. Ir a Procesos en el panel de administración
2. Click en Editar del proceso deseado
3. Copiar el ID de la URL: ...crearProceso.html?Id=abc123xyz

Problema: Error 429 — Rate Limit

Síntomas:

{
  "code": 429,
  "error": "Límite de requests excedido para este mes"
}

Causas posibles:

• Se superaron los 5000 requests mensuales del cliente
• Se hicieron requests con menos de 2 segundos de intervalo

Solución:

1. Espaciar los requests (mínimo 2 segundos entre cada uno)
2. Implementar paginación eficiente para reducir el total de requests
3. Si necesitas más cuota, contactar a soporte

import time

for page in range(1, total_pages + 1):
    response = requests.post(url, params={**params, "Page": page}, headers=headers)
    data = response.json()
    # Procesar datos...
    time.sleep(2)  # Respetar intervalo mínimo

Problema: Error de Autenticación (209)

Síntomas:

{
  "code": 209,
  "error": "Invalid session token"
}

Causas posibles:

• SessionToken incorrecto o mal copiado
• Token expirado (usuario eliminado)
• Headers incorrectos

Solución:

1. Verificar que el token es correcto (formato: r:abc123...)
2. Verificar que el usuario API existe en el panel
3. Verificar headers X-Parse-Session-Token y X-Parse-Application-Id

Problema: El proceso ya está tomado por otro usuario API

Síntomas:

{
  "code": 403,
  "error": "El proceso ya está asignado a otro usuario API"
}

Causa: Cada proceso solo puede tener un usuario API asignado a la vez.

Solución:

Opción A: Usar el usuario API existente

• Buscar cuál usuario API está asignado
• Usar sus credenciales

Opción B: Crear nuevo usuario y reasignar

1. Eliminar usuario API anterior
2. Crear nuevo usuario API
3. Hacer primer request para asociarlo al proceso

Problema: No devuelve datos

Síntomas:

{
  "result": []
}

Causas posibles:

• No hay respuestas en el rango de fechas
• ID de proceso incorrecto
• TimeZone incorrecto (fechas mal interpretadas)
• Usuario API no tiene permisos

Solución:

1. Verificar que hay respuestas en el panel web
2. Confirmar ID del proceso (ir a Editar y ver URL)
3. Probar con rango de fechas más amplio
4. Verificar TimeZone (probar con 0 = UTC)

Problema: Timeout en PowerBI

Causa: Demasiados registros o conexión lenta

Solución:

1. Reducir rango de fechas
2. Implementar paginación manual
3. Usar parámetros en PowerBI para fechas dinámicas

¿Cómo obtengo el ID del proceso?

Método:

1. Ir a Procesos
2. Click en Editar del proceso deseado
3. Ver la URL en el navegador
4. Extraer el valor después de Id=

Ejemplo de URL:

https://luuk-app.com/admin/clients/crearProceso.html?Id=abc123xyz789
                                                                   ↑
                                                        Este es el ID

ID del proceso: abc123xyz789

Recursos Adicionales

Soporte API:

• Email: info@luuk-app.com
• Consultas técnicas: Indicar "API" en asunto