Conceptos Fundamentales

1. Autenticación y Seguridad

Todos los endpoints de la API requieren autenticación mediante su token de API de Quote3D. Para llamadas externas, utilice la ruta base https://api.quote3d.com/v2. Envíelo ya sea como Authorization: Bearer <token> o X-API-Token. Genere los tokens desde su panel de control de Quote3D y manténgalos en secreto.

2. Gestión de Cuenta

Administra tu cuenta, cargas y estadísticas de uso a través de endpoints dedicados:

• GET /v2/user Obtén los detalles de tu cuenta
• GET /v2/user/uploads Lista todos los archivos que has subido a tu cuenta. Estos se listan del más reciente al más antiguo.
• GET /v2/quota Obtén tus límites de cuota actuales y uso para cotizaciones y almacenamiento
• GET /v2/usage Obtén análisis de uso detallados incluyendo estadísticas de endpoints, uso de materiales y tendencias basadas en el tiempo

3. Gestión de archivos

Sube, descarga y gestiona tus archivos de modelo 3D (formatos STL, 3MF, OBJ):

• Obtén un upload_id temporal para subir un nuevo archivo con la ruta de subida pública.: GET /v2/file/upload-id - Obtén un upload_id temporal para subir un nuevo archivo con la ruta de subida pública.
• Esta ruta NO requiere autenticación. Utilízala en tu lado del cliente para subir archivos directamente a nuestro almacenamiento.: POST /v2/file/public/{upload_id} - Esta ruta NO requiere autenticación. Utilízala en tu lado del cliente para subir archivos directamente a nuestro almacenamiento.

  Utilizar la ruta de Subida Pública te permite evitar enrutar archivos grandes a través de tu servidor backend. Esto previene exponer tu token de API y reduce la carga del servidor.

• Sube un archivo desde tu lado del servidor (requiere autenticación, utiliza esto cuando quieras subir desde tu backend): POST /v2/file — Sube un archivo desde tu lado del servidor (requiere autenticación, utiliza esto cuando quieras subir desde tu backend)
• Descarga un archivo utilizando su file_id: GET /v2/file/{file_id} — Descarga un archivo utilizando su file_id
• Elimina un archivo que ya no necesitas: DELETE /v2/file/{file_id} — Elimina un archivo que ya no necesitas

4. Información de la pieza y análisis técnico

Verifique si sus modelos son imprimibles, obtenga dimensiones de la pieza y métricas técnicas avanzadas:

• POST /v2/printability/{file_id} Análisis Instantáneo – Verifique medidas, volumen, área de superficie e integridad geométrica (bordes abiertos/non-manifold) antes de generar un presupuesto.

Quote3D va más allá de las simples verificaciones de dimensiones; analiza la integridad manifold del modelo y evalúa el riesgo de adhesión a la cama, crítico para la impresión 3D. Estas métricas se proporcionan tanto en las respuestas de Printability como de Quote.

5. Operaciones de Cotización

Genera cotizaciones instantáneas para tus impresiones 3D y gestiona el historial de cotizaciones:

• Inicia el cálculo asíncrono de un presupuesto para un modelo 3D. Devuelve un ID de trabajo; utiliza el endpoint de trabajos para obtener el resultado completado.: POST /v2/file/quote/{file_id} — Inicia el cálculo asíncrono de un presupuesto para un modelo 3D. Devuelve un ID de trabajo; utiliza el endpoint de trabajos para obtener el resultado completado.
• Endpoint asíncrono alternativo para generar presupuestos. Devuelve un ID de trabajo que puedes usar para verificar el estado y obtener el resultado completado.: POST /v2/file/quote/{file_id}/async — Endpoint asíncrono alternativo para generar presupuestos. Devuelve un ID de trabajo que puedes usar para verificar el estado y obtener el resultado completado.
• Verifica el estado de un trabajo de cotización asíncrono. Devuelve el porcentaje de progreso y el estado de finalización.: GET /v2/jobs/{job_id} — Verifica el estado de un trabajo de cotización asíncrono. Devuelve el porcentaje de progreso y el estado de finalización.
• Recupera todo tu historial de cotizaciones con soporte de paginación: GET /v2/quotes — Recupera todo tu historial de cotizaciones con soporte de paginación
• Obtén información detallada sobre una cotización específica: GET /v2/quotes/{quote_id} — Obtén información detallada sobre una cotización específica
• Elimina una cotización de tu historial: DELETE /v2/quotes/{quote_id} — Elimina una cotización de tu historial

Parámetros de Solicitud de Cotización

Al generar una cotización, puedes proporcionar una configuración personalizada en el cuerpo de la solicitud. Cualquier parámetro que no especifiques se tomará automáticamente de la configuración de tu Perfil de Rebanado en el Panel de Control. Esto te permite anular configuraciones específicas por cotización mientras mantienes los valores predeterminados para otras.

Parámetros Raíz

Lógica de Cantidad y Producción por Lotes

Nuestro sistema utiliza un algoritmo de empaquetado avanzado basado en la 'cantidad' especificada:

• Tecnología FDM: Las piezas se colocan lado a lado en la placa de construcción (ejes X e Y) según el espacio disponible.
• Tecnología SLA: Las piezas se posicionan lado a lado en el recipiente de resina (ejes X e Y).
• Tecnología SLS: Las piezas se pueden apilar en todos los ejes (X, Y y Z) para utilizar completamente la capacidad de la cama de polvo.

printer_config

Parámetros de configuración de la impresora. Todos los campos son opcionales y utilizarán los valores predeterminados de tu Perfil de Impresora si no se proporcionan.

material_config

Parámetros de configuración del material. Todos los campos son opcionales y utilizarán los valores predeterminados de tu Perfil de Material si no se proporcionan.

quote_config

Parámetros de configuración de precios de la cotización. Todos los campos son opcionales y utilizarán los valores predeterminados de tu Configuración Global si no se proporcionan. La moneda predeterminada es la de tu panel de control (por ejemplo, 'USD', 'TRY', 'EUR').

6. Perfiles de Impresora y Presupuesto

Configure los ajustes de la impresora y los precios para obtener presupuestos precisos. Puede administrar sus perfiles predeterminados en la sección Perfiles de Rebanado del Panel de Control, que se utilizarán automáticamente cuando no especifique parámetros en las solicitudes de API.

Tipos de perfil

• Perfil de Impresora - Configure los ajustes de su impresora (tamaño de la cama, diámetro de la boquilla, velocidad de impresión, altura de capa, aceleración, jerk, temperaturas, etc.) para que coincidan con su impresora real. Establezca esto como su perfil predeterminado en el Panel de Control y se utilizará para todas las solicitudes de presupuesto a menos que anule parámetros específicos.
• Perfil de Material - Establezca las propiedades del material (tipo de filamento, densidad, diámetro, temperaturas, velocidad del ventilador, ajustes de retracción, precios) para cada material que utilice. La API utilizará automáticamente el perfil de material que coincida con el filament_type que especifique en la solicitud.
• Configuración Global - Configure la configuración global de cotización, como la tasa de impuestos, las tarifas fijas, los costos de energía y la moneda predeterminada. Estos ajustes se aplican a todas las cotizaciones a menos que se anulen en la solicitud.

Cómo Funcionan las Mezclas de Perfiles

Cuando realiza una solicitud de presupuesto, la API combina los parámetros de su solicitud con sus perfiles del Panel de Control utilizando esta prioridad:

1. Parámetros de Solicitud - Los valores que proporciona explícitamente en la solicitud de API tienen la prioridad más alta
2. Perfil de Usuario - Si tiene un perfil específico del usuario establecido como predeterminado, se utiliza a continuación
3. Perfil Global - Si no existe un perfil de usuario, el sistema recurre a los valores predeterminados globales

Esto significa que puede anular solo los parámetros que necesita (por ejemplo, solo layer_height o fill_density) mientras mantiene todos los demás ajustes de sus perfiles del Panel de Control.

7. Webhooks

Recibe notificaciones en tiempo real cuando se producen eventos en tu cuenta:

• POST /v2/webhooks - Crear un nuevo punto final de webhook
• GET /v2/webhooks - Listar todos tus webhooks
• GET /v2/webhooks/{webhook_id} - Obtener los detalles del webhook y las estadísticas de entrega
• PUT /v2/webhooks/{webhook_id} - Actualizar la configuración del webhook
• DELETE /v2/webhooks/{webhook_id} - Eliminar un webhook

Eventos admitidos: quote.completed, quote.failed, job.status_changed, widget.added_to_cart, file.uploaded. Los webhooks incluyen firmas HMAC-SHA256 para la verificación de seguridad.

8. Analítica e Informes

Obtén información sobre el uso de tu API y las estadísticas de cotizaciones:

• GET /v2/analytics/quotes - Obtén estadísticas completas de cotizaciones, incluyendo el total de cotizaciones, precios promedio y tendencias de uso de materiales
• GET /v2/analytics/popular - Visualiza tus materiales y configuraciones de impresora más populares
• GET /v2/analytics/cost-trends - Analiza las tendencias de costos a lo largo del tiempo (agrupación diaria, semanal o mensual)
• GET /v2/analytics/export - Exporta tus cotizaciones y datos de uso como CSV o JSON

9. Limitación de Velocidad y Cuotas

Quote3D utiliza la limitación de velocidad para asegurar un uso justo y la estabilidad del sistema:

• Los límites de velocidad se aplican por token de API y varían según el endpoint
• La información sobre los límites de velocidad se incluye en las cabeceras de la respuesta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
• Cuando se alcanza el límite de velocidad, recibirá una respuesta 429 Too Many Requests con una cabecera Retry-After
• Las cuotas mensuales para cotizaciones y almacenamiento se basan en su plan de suscripción

10. API RESTful con versiones

• Todos los endpoints están versionados (ej., /v2/)
• Utiliza métodos HTTP estándar:
• Sigue los estándares OpenAPI 3.1.0 para el esquema y la documentación
• El registro de cambios de la API está disponible en: