Referencia API

Referencia completa para endpoints de API MADFAM, autenticación y ejemplos de integración.

→ Authentication Guide→ Rate Limits→ Error Codes→ SDKs & Libraries

URL base

https://api.madfam.io

Authentication

POST/api/auth/login

Authenticate user and receive access token

POST/api/auth/refresh

Refresh access token using refresh token

POST/api/auth/logout

Invalidate user session and tokens

Assessment

POST/api/assessment

Submit AI readiness assessment

GET/api/assessment/:id

Retrieve assessment results

Calculator

POST/api/calculator

Calculate ROI based on input parameters

GET/api/calculator/presets

Get industry-specific calculation presets

Leads

POST/api/leads

Submit a new lead

GET/api/leads

List all leads (admin only)

PUT/api/leads/:id

Update lead status

Ejemplos de código

Ejemplo de autenticación

// Authentication Example
const response = await fetch('https://api.madfam.io/api/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: 'user@example.com',
    password: 'secure-password'
  })
});

const { token } = await response.json();

Envío de evaluación

// Assessment Example
const response = await fetch('https://api.madfam.io/api/assessment', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_TOKEN'
  },
  body: JSON.stringify({
    companySize: 'medium',
    industry: 'manufacturing',
    currentTools: ['erp', 'crm'],
    challenges: ['efficiency', 'scalability']
  })
});

Límite de solicitudes

Las solicitudes de API están limitadas para garantizar un uso justo y la estabilidad del sistema.

100
Solicitudes por minuto
1000
Solicitudes por hora
10000
Solicitudes por día