API Documentation
Documentación para desarrolladores
Versión: v1 | Base URL: https://api.m4kers.com/api/v1
Autenticación Requerida
La mayoría de endpoints requieren autenticación vía Bearer token.
Autenticación
Authorization: Bearer <your_token>
Obtén tu token iniciando sesión:
POST /auth/login{"email": "[email protected]","password": "your_password"}
✓ Respuesta
{"token": "eyJhbGciOiJIUzI1NiIs...","user": {"id": 123, "username": "maker"}}Modelos 3D
/modelsListar todos los modelos (páginado)
/models/:slugObtener detalles de un modelo
/modelsCrear un nuevo modelo (requiere autenticación)
{"title": "Mi Modelo","description": "Descripción...","category": "figures","license": "CC-BY","visibility": "public"}/models/:idActualizar un modelo (solo propietario)
/models/:idEliminar un modelo (solo propietario)
Marketplace
/marketplaceListar productos del marketplace
/marketplaceCrear un listing (solo makers)
{"title": "Figura impresa","description": "...","price": 25.00,"currency": "EUR","materials": ["PLA", "PETG"]}/listings/:idActualizar un listing
Pedidos
/orders/checkoutProcesar checkout y crear pedido
{"items": [{"listingId": 456, "quantity": 1}],"currency": "EUR"}/ordersListar mis pedidos (como buyer)
/orders/:id/statusActualizar estado del pedido (solo maker)
{"status": "PROCESSING"}Presupuestos
/quotesSolicitar presupuesto de impresión
{"makerId": 789,"message": "Necesito imprimir este modelo...","modelSlug": "figura-voronoi"}/quotesListar mis presupuestos
/quotes/:id/messagesResponder a un presupuesto (solo maker)
{"message": "Puedo hacerlo por 30€","price": 30.00,"currency": "EUR"}Códigos de Error
Bad Request
Solicitud inválida
Unauthorized
Token inválido o ausente
Forbidden
Sin permisos
Not Found
Recurso no existe
Rate Limited
Demasiadas solicitudes
Server Error
Error del servidor
Formato de respuesta de error:
{"error": "Validation failed","message": "Invalid input data","details": {"field": "email"}}¿Necesitas ayuda?
Contacta con nuestro equipo de soporte: [email protected]