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

Inicio rápido de la API de presupuestos 3D

¡Póngase en marcha con la API de Quote3D en menos de 5 minutos! Para integraciones externas, realice llamadas a los endpoints desde https://api.quote3d.com/v2. Siga estos pasos para crear su cuenta, generar un token de API y empezar a realizar sus primeras llamadas a la API.

1

Cree Su Cuenta

  1. Visita el panel de control de Quote3D para registrarte y crear una nueva cuenta
  2. Complete el formulario de registro con sus datos
  3. Revise su correo electrónico y haga clic en el enlace de confirmación para activar completamente su cuenta

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

2

Generar su Token de API

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

¡Solo verá el token una vez! Asegúrese 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. Haga clic en el icono de candado en la esquina superior derecha
  3. Pegue su token JWT del Paso 2 en el campo de autorización
  4. Haga Authorize

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

4

Realice su Primera Llamada a la API

¿Listo para probarlo? Intente subir su 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 puede 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 su clave para administrar y referenciar sus 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

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

  1. ¿Necesita subir desde su 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. ¿Necesita una cotización? Comience con POST https://api.quote3d.com/v2/file/quote/{file_id}.
  5. ¿Esperando la finalización de la cotización? Consulte GET https://api.quote3d.com/v2/jobs/{job_id} hasta que el estado sea completed, failed o cancelled. Los valores de estado van en minúsculas, y un trabajo fallido sigue respondiendo HTTP 200.
  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

A dónde ir después

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.