API v1.0 — Online

Documentación API DM360

Conecta tu software con nuestro catálogo de más de 180.000 piezas de eco-recambio. API REST documentada, ejemplos en múltiples lenguajes y colección Postman lista para usar.

Inicio Rápido

PASO 1

Obtén tu API Key

Solicita tu clave a nuestro equipo de soporte > Claves API.

PASO 2

Autentícate

Incluye tu API key en el header Authorization: Bearer <tu-api-key> en cada petición.

PASO 3

Haz llamadas

Comienza a consultar nuestro catálogo de 180.000+ piezas desde tu software.

Autenticación

Header de Autorización

Todas las llamadas a la API deben incluir el header de autorización con tu API key.

HTTP Header
Authorization: Bearer dm360_tu_clave_aqui
Alternativa: X-API-Key: dm360_tu_clave_aqui
URL Base
https://api.desguacesmora.com

Seguridad

Mantén tu API key segura. No la incluyas en código frontend ni repositorios públicos.

Endpoints Disponibles

Haz clic en cada endpoint para ver sus parámetros

Obtener listado de piezas con filtros opcionales

ParámetroTipoDescripciónRequerido
pagenumberNúmero de página (por defecto: 1)No
limitnumberResultados por página (máximo: 100)No
searchstringBúsqueda por nombre o referenciaNo
categorystringFiltrar por categoríaNo
brandstringFiltrar por marca del vehículoNo
modelstringFiltrar por modelo del vehículoNo
minPricenumberPrecio mínimoNo
maxPricenumberPrecio máximoNo
availablebooleanSolo piezas disponibles (por defecto: true)No

Ejemplos de Código

// Ejemplo: Obtener piezas con autenticación
const apiKey = 'dm360_tu_clave_aqui';
const baseUrl = 'https://api.desguacesmora.com';

async function getParts() {
  try {
    const response = await fetch(`${baseUrl}/api/v1/public/parts?page=1&limit=20`, {
      method: 'GET',
      headers: {
        'Authorization': `Bearer ${apiKey}`,
        'Content-Type': 'application/json',
      },
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    console.log('Piezas:', data);
    return data;
  } catch (error) {
    console.error('Error:', error);
  }
}

getParts();

Formato de Respuesta

Respuesta Exitosa

{
  "success": true,
  "data": [
    {
      "id": "string",
      "nombre": "string",
      "referencia": "string",
      "precio": 1250.00,
      "disponible": true,
      "categoria": "Motores",
      "marca": "Volkswagen",
      "peso": 200,
      "imagenes": ["url"],
      "createdAt": "ISO 8601",
      "updatedAt": "ISO 8601"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 180000,
    "pages": 9000
  }
}

Respuesta de Error

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API key inválida",
    "details": null
  }
}

Códigos HTTP

200Petición exitosa
400Parámetros inválidos
401API key inválida o ausente
404Recurso no encontrado
429Límite de tasa excedido
500Error interno del servidor

Límites de Tasa

Límites Estándar

1.000 peticiones/hora
100 peticiones/minuto
10 conexiones simultáneas

Headers de Respuesta

// Headers incluidos en cada respuesta
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1640995200

Si necesitas límites superiores, contacta con nuestro equipo para un plan enterprise.

Colección Postman

Prueba la API al instante

Descarga nuestra colección oficial de Postman con todos los endpoints preconfigurados, variables de entorno y ejemplos de respuesta. Solo necesitas tu API Key para empezar.

7 Endpoints

Todos los endpoints de la API preconfigurados y listos para probar.

Variables de entorno

base_url y api_key como variables para cambiar fácilmente entre entornos.

Ejemplos de respuesta

Cada endpoint incluye ejemplos de respuestas exitosas y de error.

Documentación inline

Descripción detallada de cada endpoint y parámetro dentro de Postman.

Soporte Técnico

Horario de Soporte

Lunes - Viernes Tarde: 08:00 - 14:00

Lunes - Viernes Tarde: 16:00 - 19:00

Sábados: Cerrado

Domingos: Cerrado