Resumen de endpoints

Todos los endpoints usan la URL base: https://your-app-domain.com/api/public

Elegibilidad de garantía

Método	Ruta	Descripción
GET / POST	/warranty-eligibility	Verifica la elegibilidad de garantía de un producto
POST	/warranty/eligibility	Verifica la elegibilidad de una línea de pedido
GET / POST	/assess-eligibility	Reevalúa en lote la elegibilidad de una organización (administración)
GET	/assess-eligibility/all	Evalúa en lote todas las organizaciones (administración)

Garantías

Método	Ruta	Descripción
GET	/warranty/{warrantyId}	Obtiene los detalles de una garantía por ID

Pólizas

Método	Ruta	Descripción
GET	/policies/fetch	Obtiene todas las pólizas de un cliente
GET	/policies/fetch/{policyId}	Obtiene una póliza específica por ID
POST	/policies/fetch/order-line-item-policy	Busca la póliza de una línea de pedido
POST	/policies/validate	Valida una póliza por ID y nombre del pedido

Reclamos

Método	Ruta	Descripción
POST	/claims/submit	Envía un reclamo de garantía sobre una póliza
POST	/claims/submit-manual	Envía un reclamo iniciado por el comerciante (no requiere póliza)
GET	/claims/fetch	Obtiene los reclamos de una póliza y un cliente
GET	/claims/{id}/evidence	Obtiene los archivos de evidencia de un reclamo
POST	/claims/upload-urls	Genera URL de carga prefirmadas para la evidencia
POST	/claims/upload	Carga la evidencia del reclamo directamente
POST	/claims/evidence	Adjunta los metadatos de la evidencia a un reclamo

Productos

Método	Ruta	Descripción
GET	/products/search	Busca productos por título, SKU o código de barras
GET	/products/eligibility	Verifica la elegibilidad de varios productos
POST	/products/register	Registra un producto para la cobertura de garantía

Clientes

Método	Ruta	Descripción
GET	/customers/orders	Obtiene los pedidos de un cliente

Registro

Método	Ruta	Descripción
GET	/registration/lookup	Busca un registro por número

Números de serie

Método	Ruta	Descripción
POST	/serial-numbers/validate	Valida un número de serie

Analíticas

Método	Ruta	Descripción
POST	/analytics/events	Envía eventos de analíticas del widget

Configuración

Método	Ruta	Descripción
GET / POST	/config	Obtiene la configuración y las traducciones del widget

Estado del pedido

Método	Ruta	Descripción
GET	/order-status	Obtiene el estado de un pedido

POS

Método	Ruta	Descripción
GET	/pos/customer-search	Busca clientes en un contexto de POS

Integración con Shopify

Método	Ruta	Descripción
GET	/shopify/auth/callback	Callback de OAuth para la instalación de la app
POST	/shopify/webhooks	Recibe eventos de Webhook de Shopify
POST	/shopify/post-purchase/sign-changeset	Firma los changesets de la extensión posterior a la compra

Sincronización de productos

Método	Ruta	Descripción
POST	/sync-products	Sincroniza los productos de una organización
POST	/sync-products/all	Sincroniza los productos de todas las organizaciones

Estado de la API

Método	Ruta	Descripción
GET	/health	Verifica el estado de salud de la API

Devuelve 200 (en buen estado), 206 (degradado) o 503 (fuera de servicio).

Relacionado

• Autenticación — Configuración de claves de API y límites de solicitudes
• API de garantías — Referencia detallada de los endpoints de garantías
• API de reclamos — Referencia detallada de los endpoints de reclamos
• API de pólizas — Referencia detallada de los endpoints de pólizas