API & Integrazioni

Integra Praxyo con i tuoi strumenti e automatizza i flussi di lavoro con la nostra API REST completa.

REST API

API Potente e Documentata

L'API REST di Praxyo ti consente di accedere a tutti i dati e le funzionalità della piattaforma in modo programmatico. Progettata seguendo le best practice REST, offre endpoint intuitivi, risposte JSON strutturate e supporto per paginazione, filtri e ordinamento.

  • ✓Base URL: https://api.praxyo.com/v1
  • ✓Formato risposte: JSON
  • ✓Autenticazione: OAuth 2.0 e API Key
  • ✓Versioning: tramite URL path (/v1, /v2)
API REST Praxyo
AUTENTICAZIONE

Authentication

Due modalità di autenticazione per ogni esigenza.

API Key

Ideale per integrazioni server-to-server. Genera una API key dalle Impostazioni del tuo account e includila nell'header di ogni richiesta.

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

OAuth 2.0

Per applicazioni che agiscono per conto di un utente. Supporta il flusso 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

Accedi a tutte le risorse della piattaforma tramite endpoint 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

Esempio di Risposta

{
  "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

Per garantire la stabilità del servizio, le API sono soggette a limiti di utilizzo.

🚀

Free

100

richieste / ora

⚡

Professional

1.000

richieste / ora

🌟

Enterprise

10.000

richieste / ora

Gli header di risposta includono informazioni sul rate limiting:

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

SDK Disponibili

Librerie ufficiali per i linguaggi più diffusi.

💻

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

Ricevi notifiche in tempo reale quando si verificano eventi sulla piattaforma.

Eventi Disponibili

  • ✓project.created — Nuovo progetto creato
  • ✓task.created — Nuova attività creata
  • ✓task.completed — Attività completata
  • ✓task.assigned — Attività assegnata
  • ✓time_entry.created — Registrazione tempo
  • ✓expense.created — Spesa registrata

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..."
}

Pronto a trasformare il tuo modo di lavorare?

Unisciti a migliaia di team che usano Praxyo per gestire i propri progetti in modo più intelligente.