Skip to main content
    API v1

    Documentación para Desarrolladores

    Crea integraciones personalizadas con la API REST de Clockwork. Gestiona clientes, trabajos, facturas y pagos de forma programática.

    URL Base: https://api.runclockwork.com/v1Autenticación con Bearer tokenLímite de 100 req/min

    Autenticación

    Todas las solicitudes requieren un Bearer token en el header de Authorization. Genera tu clave de API desde el Portal en Configuración > Acceso a API.

    bash
    curl -X GET "https://api.runclockwork.com/v1/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

    Recursos

    Clientes

    Crea, lee, actualiza y gestiona registros de clientes.

    GET
    /api/v1/customers

    Lista todos los clientes con paginación y filtros

    POST
    /api/v1/customers

    Crea un nuevo registro de cliente

    GET
    /api/v1/customers/:id

    Obtiene un cliente específico por ID

    PATCH
    /api/v1/customers/:id

    Actualiza los datos del cliente

    DELETE
    /api/v1/customers/:id

    Elimina un registro de cliente

    Solicitud de Ejemplo

    bash
    curl -X POST "https://api.runclockwork.com/v1/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith",
    "email": "john@example.com",
    "phone": "+15551234567",
    "address": {
      "street": "123 Main St",
      "city": "Phoenix",
      "state": "AZ",
      "zip": "85001"
    },
    "notes": "Referido por Mike. Tiene dos unidades de AC."
  }'

    SDKs

    Librerías oficiales — puedes llamar la API REST directamente hoy; los SDKs llegan junto con el lanzamiento público de la API.

    JavaScript / TypeScriptPróximamente
    PythonPróximamente
    GoPróximamente
    PHPPróximamente

    Límites de Tasa y Errores

    Límites de Tasa

    • 100 solicitudes por minuto (plan gratis)
    • 1,000 solicitudes por minuto (plan growth)
    • Encabezados de límite de tasa incluidos en cada respuesta

    Códigos HTTP

    200Éxito
    201Creado
    400Solicitud incorrecta
    401No autorizado
    404No encontrado
    429Límite excedido
    500Error del servidor

    ¿Listo para construir?

    Crea tu cuenta gratis de Clockwork y genera una clave de API en menos de 5 minutos. Acceso completo, sin restricciones.

    Obtener tu Clave de APIContactar a Soporte de Desarrolladores