CRM Bética de Aislamientos S.L V.1.1

Documentación API REST

Volver
Información General
Base URL
https://betica.inbaraka.com/api/v1
Autenticación

Todas las peticiones requieren autenticación mediante Bearer Token:

Authorization: Bearer YOUR_API_TOKEN
Formato de Respuesta

Todas las respuestas se devuelven en formato JSON:

Content-Type: application/json
Códigos de Estado HTTP
  • 200 OK - Petición exitosa
  • 201 Created - Recurso creado
  • 400 Bad Request - Petición inválida
  • 401 Unauthorized - No autenticado
  • 403 Forbidden - Sin permisos
  • 404 Not Found - Recurso no encontrado
  • 500 Internal Error - Error del servidor
Rate Limiting
  • 📊 1000 peticiones por hora
  • 📊 10000 peticiones por día
  • 📊 Headers de límite en cada respuesta
Endpoints Disponibles
GET /api/v1/clients
Bearer Token

Obtener lista de clientes

Parámetros: limit offset status
POST /api/v1/clients
Bearer Token

Crear nuevo cliente

Parámetros: name email phone company
GET /api/v1/opportunities
Bearer Token

Obtener oportunidades

Parámetros: stage assigned_to date_from date_to
POST /api/v1/opportunities
Bearer Token

Crear oportunidad

Parámetros: title client_id value stage
POST /api/v1/leads
Bearer Token

Crear lead/prospecto

Parámetros: name email phone source
GET /api/v1/tasks
Bearer Token

Obtener tareas

Parámetros: status assigned_to due_date
POST /api/v1/webhooks
API Key

Registrar webhook

Parámetros: url events
Ejemplos de Uso
Ejemplo: Obtener lista de clientes
curl -X GET "https://betica.inbaraka.com/api/v1/clients?limit=10&status=activo" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json"
Respuesta (JSON):
{
  "success": true,
  "data": [
    {
      "id": 1,
      "name": "Los Olivos Construcciones",
      "email": "contacto@losolivos.com",
      "phone": "+34 954 123 456",
      "status": "activo",
      "created_at": "2025-07-15T10:30:00Z"
    }
  ],
  "pagination": {
    "total": 45,
    "page": 1,
    "per_page": 10
  }
}
Ejemplo: Crear nueva oportunidad
curl -X POST "https://betica.inbaraka.com/api/v1/opportunities" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "title": "Proyecto Aislamiento Térmico",
       "client_id": 1,
       "value": 45000,
       "stage": "qualification",
       "assigned_to": 10
     }'