KOAJ Catalog API

📊 Estado de Endpoints

Estado actual de todos los endpoints de la API KOAJ Catalog

Última actualización: 26 de Junio 2025

🎯 Resumen Ejecutivo

✅ 9/15 Funcionando

60% de endpoints operativos

🔓 Sin Autenticación

Endpoints principales públicos

📦 Mock Data

Datos de ejemplo para testing

🚀 Listo para Dev

APIs core funcionales

📋 Estado Detallado por Endpoint

Endpoint Método Estado Código Notas
🔐 AUTHENTICATION
/auth/login POST ✅ FUNCIONA 200 Token generation OK
/auth/verify POST ❌ ERROR 500 Lambda routing issue
/auth/validate GET ❌ ERROR 500 New endpoint not routing
/auth/refresh POST ❌ ERROR 500 New endpoint not routing
📦 PRODUCTS
/products GET ✅ FUNCIONA 200 Pagination, filters OK
/products/{id} GET ✅ FUNCIONA 200 Single product details OK
🔍 SEARCH
/search/hybrid POST ✅ FUNCIONA 200 Query, filters, scoring OK
/search/semantic POST ✅ FUNCIONA 200 Semantic matching OK
📊 INVENTORY
/inventory/{sku} GET ✅ FUNCIONA 200 Stock levels, stores OK
🐦 BIRD.COM INTEGRATION
/bird/search POST ❌ ERROR 500 New endpoint routing issue
/bird/sync-catalog POST ✅ FUNCIONA 200 Catalog sync OK
/bird/webhooks POST ✅ FUNCIONA 200 Webhook processing OK
/bird/send-message POST ⚠️ PARCIAL 200 Response OK but validation issue
/bird/status GET ❌ ERROR 500 New endpoint routing issue
/bird/products GET ❌ ERROR 500 New endpoint routing issue

🛠️ Problemas Conocidos

1. Lambda Routing Issues (Crítico)

Los nuevos endpoints no llegan a las Lambda functions. Afecta:

  • /auth/verify, /auth/validate, /auth/refresh
  • /bird/search, /bird/status, /bird/products

2. Authorization Headers

API Gateway puede estar filtrando headers Authorization. Afecta principalmente /auth/verify.

✅ Endpoints Listos para Uso

Productos:

GET https://xwix14ai8e.execute-api.us-east-2.amazonaws.com/v1/products

Búsqueda Híbrida:

POST https://xwix14ai8e.execute-api.us-east-2.amazonaws.com/v1/search/hybrid
Content-Type: application/json

{
  "query": "vestido azul elegante",
  "limit": 10
}

Inventario:

GET https://xwix14ai8e.execute-api.us-east-2.amazonaws.com/v1/inventory/105205520123-936

📚 Recursos