API e integraciones

Integra Praxyo con tus herramientas y automatiza los flujos de trabajo con nuestra API REST completa.

REST API

Una API potente y bien documentada

La API REST de Praxyo te permite acceder de forma programática a todos los datos y funcionalidades de la plataforma. Diseñada según las buenas prácticas REST, ofrece endpoints intuitivos, respuestas JSON estructuradas y soporte para paginación, filtros y ordenación.

  • ✓Base URL: https://api.praxyo.com/v1
  • ✓Formato de respuesta: JSON
  • ✓Autenticación: OAuth 2.0 y API Key
  • ✓Versionado: mediante la ruta de la URL (/v1, /v2)
API REST Praxyo
AUTENTICAZIONE

Authentication

Dos métodos de autenticación para cada necesidad.

API Key

Ideal para integraciones servidor a servidor. Genera una API key desde los Ajustes de tu cuenta e inclúyela en el header de cada solicitud.

curl -X GET "https://api.praxyo.com/v1/projects" \
  -H "Authorization: Bearer pk_live_abc123def456" \
  -H "Content-Type: application/json"

OAuth 2.0

Para aplicaciones que actúan en nombre de un usuario. Admite el flujo Authorization Code con PKCE.

POST https://auth.praxyo.com/oauth/token
Content-Type: application/x-www-form-urlencoded

grant_type=authorization_code
&code=AUTH_CODE_HERE
&client_id=YOUR_CLIENT_ID
&client_secret=YOUR_CLIENT_SECRET
&redirect_uri=https://yourapp.com/callback
ENDPOINT

Principali Endpoint

Accede a todos los recursos de la plataforma mediante endpoints RESTful.

Progetti

GET    /v1/projects              # Lista progetti
POST   /v1/projects              # Crea progetto
GET    /v1/projects/:id          # Dettaglio progetto
PUT    /v1/projects/:id          # Aggiorna progetto
DELETE /v1/projects/:id          # Elimina progetto

Attività

GET    /v1/projects/:id/tasks    # Lista attività
POST   /v1/projects/:id/tasks    # Crea attività
GET    /v1/tasks/:id             # Dettaglio attività
PUT    /v1/tasks/:id             # Aggiorna attività
DELETE /v1/tasks/:id             # Elimina attività

Time Tracking

GET    /v1/time-entries           # Lista registrazioni
POST   /v1/time-entries           # Crea registrazione
PUT    /v1/time-entries/:id       # Aggiorna registrazione
DELETE /v1/time-entries/:id       # Elimina registrazione
POST   /v1/time-entries/start     # Avvia timer
POST   /v1/time-entries/stop      # Ferma timer

Ejemplo de respuesta

{
  "result": true,
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "Website Redesign",
    "status": "active",
    "created": "2026-03-01T10:30:00Z",
    "tasks_count": 24,
    "completed_tasks": 18
  },
  "message": null
}
LIMITI

Rate Limiting

Para garantizar la estabilidad del servicio, las API están sujetas a límites de uso.

🚀

Free

100

solicitudes / hora

⚡

Professional

1.000

solicitudes / hora

🌟

Enterprise

10.000

solicitudes / hora

Los headers de respuesta incluyen información sobre el límite de solicitudes:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 847
X-RateLimit-Reset: 1711036800
SDK

SDK Disponibili

Librerías oficiales para los lenguajes más populares.

💻

JavaScript / TypeScript

npm install @praxyo/sdk
🐍

Python

pip install praxyo
⚖

C# / .NET

dotnet add package Praxyo.SDK
☕

Java / Kotlin

implementation 'com.praxyo:sdk:1.0'
WEBHOOK

Webhook

Recibe notificaciones en tiempo real cuando se producen eventos en la plataforma.

Eventi Disponibili

  • ✓project.created — Nuevo proyecto creado
  • ✓task.created — Nueva tarea creada
  • ✓task.completed — Tarea completada
  • ✓task.assigned — Tarea asignada
  • ✓time_entry.created — Registro de tiempo
  • ✓expense.created — Gasto registrado

Esempio Payload

{
  "event": "task.completed",
  "timestamp": "2026-03-19T14:30:00Z",
  "data": {
    "task_id": "550e8400-e29b-41d4-a716-446655440000",
    "project_id": "660f9500-f39c-52e5-b827-557766551111",
    "name": "Design homepage mockup",
    "completed_by": "user@example.com"
  },
  "signature": "sha256=abc123..."
}

¿Listo para transformar tu forma de trabajar?

Únete a miles de equipos que usan Praxyo para gestionar sus proyectos de forma más inteligente.