¡Bienvenido a la Documentación de Quote3D! ⏳
Quote3D LogoQuote3DDocumentación

Guía de inicio rápido 🚀

¡Ponte en marcha con la API de Quote3D en menos de 5 minutos! Para integraciones externas, realiza llamadas a los endpoints desde https://api.quote3d.com/v2. Sigue estos pasos para crear tu cuenta, generar un token de API y empezar a realizar tus primeras llamadas a la API.

1

Crea Tu Cuenta

  1. Visita el panel de control de Quote3D para registrarte y crear una nueva cuenta
  2. Completa el formulario de registro con tus datos
  3. Revisa tu correo electrónico y haz clic en el enlace de confirmación para activar completamente tu cuenta

Asegúrate de confirmar tu dirección de correo electrónico o tu cuenta no se activará completamente y no podrás acceder a la API!

2

Generar tu Token de API

  1. Inicia sesión en tu cuenta de Quote3D
  2. Navega al panel de control - serás redirigido aquí automáticamente después de iniciar sesión
  3. Haz clic en la pestaña Tokens en la barra lateral izquierda
  4. Crea un nuevo token haciendo clic en el botón Nuevo Token
  5. Configura tu token
    • Dale un nombre descriptivo (por ejemplo, "Mi Primer Token")
    • Establece la caducidad en días (déjalo en blanco para que no caduque)
  6. Copia el token generado inmediatamente y guárdalo de forma segura

¡Solo verás el token una vez! Asegúrate de copiarlo y guardarlo en una ubicación segura antes de cerrar la ventana emergente.

3

Autentícate con la API

  1. Navega al patio de juegos de la API en /docs/playground
  2. Haz clic en el icono de candado en la esquina superior derecha
  3. Pega tu token JWT del Paso 2 en el campo de autorización
  4. Haz Authorize

🎉 ¡Felicidades! Ahora estás autenticado y listo para explorar la API de Quote3D.

4

Realiza tu Primera Llamada a la API

¿Listo para probarlo? Intenta subir tu primer archivo STL:

  1. Busca el endpoint POST https://api.quote3d.com/v2/file en la documentación de la API
  2. Expande la pestaña para revelar los detalles de la solicitud POST
  3. Cargue un archivo STL usando el botón "choose file" para abrir el explorador de archivos
  4. Ejecuta la solicitud

La respuesta incluirá un ID de archivo que puedes usar para:

  • Verificar dimensiones e imprimibilidad
  • Generar cotizaciones para estimaciones de precios instantáneas automatizadas
  • Gestionar el archivo subido para ahorrar espacio en su almacenamiento en la nube

El file_id actúa como tu clave para administrar y referenciar tus archivos subidos en llamadas a la API posteriores. Es el identificador único del que se derivan todas las demás llamadas a la API.

Árbol de decisión de endpoints

Utiliza esta ruta rápida para decidir qué endpoint llamar a continuación en https://api.quote3d.com/v2.

  1. ¿Necesitas subir desde tu backend? Utilice POST https://api.quote3d.com/v2/file con su token Bearer.
  2. ¿Necesita una subida directa desde el navegador sin exponer su token? Obtenga un ID de carga mediante GET https://api.quote3d.com/v2/file/upload-id, luego realice la carga con POST https://api.quote3d.com/v2/file/public/{upload_id}.
  3. ¿Necesita validación de tamaño/ajuste antes de la tarificación? Llamar a POST https://api.quote3d.com/v2/printability/{file_id}.
  4. ¿Necesitas una cotización? Comience con POST https://api.quote3d.com/v2/file/quote/{file_id}.
  5. ¿Esperando la finalización de la cotización? Realizar peticiones GET a https://api.quote3d.com/v2/jobs/{job_id} hasta que el estado sea COMPLETED, FAILED o CANCELLED.
  6. ¿Necesita el historial o los detalles de las cotizaciones almacenadas? Utilice GET https://api.quote3d.com/v2/quotes y GET https://api.quote3d.com/v2/quotes/{quote_id}.

Nota: Si no envía los detalles de tecnología, impresora o material en las solicitudes de presupuesto, la API utilizará la configuración predeterminada de su perfil de usuario.

Errores comunes y qué hacer a continuación

Acciones rápidas para los casos límite más comunes.

429 Límite de velocidad: Lea los encabezados X-RateLimit-* y Retry-After, espere y luego reintente con backoff exponencial.

Formato de archivo no válido: Carga solo archivos STL, 3MF u OBJ. Vuelve a exportar el modelo y verifica la integridad del archivo.

El modelo no cabe en la cama: Ejecute primero la comprobación de imprimibilidad, reduzca la escala del modelo o seleccione un perfil de impresora o volumen de impresión más grande.

Advertencia de anomalía de unidades: Es probable que su modelo utilice una escala de pulgadas/metros. Vuelva a exportar en milímetros (mm) e inténtelo de nuevo.

¿Qué sigue?

Ahora que está configurado, explore estas funciones clave:

  • Gestión de archivos - Cargue, descargue y administre sus archivos de modelo 3D (STL, 3MF, OBJ)
  • Verificación de imprimibilidad - Verifique si sus modelos se ajustan a las dimensiones de su impresora
  • Generación de presupuesto - Obtenga precios instantáneos en su moneda preferida con estimaciones detalladas del uso de material y el tiempo de impresión
  • Historial de presupuestos - Acceda a todos sus presupuestos anteriores y adminístrelos
  • Webhooks - Reciba notificaciones en tiempo real para la finalización de presupuestos y la carga de archivos
  • Análisis - Realice un seguimiento de su uso, los materiales populares y las tendencias de costos
  • Administración de cuentas - Supervise sus cuotas, estadísticas de uso y detalles de suscripción

Importante: Todos los puntos finales de la API requieren autenticación con su token Bearer. Asegúrese de incluirlo en el encabezado de Autorización de cada solicitud.

Ejemplo: Authorization: Bearer YOUR_TOKEN_HERE

¿Necesita ayuda? Consulte nuestra guía de Conceptos básicos o explore el Playground de la API para obtener documentación interactiva.