API et intégrations

REST API

Une API puissante et bien documentée

L’API REST de Praxyo vous permet d’accéder par programmation à toutes les données et fonctionnalités de la plateforme. Conçue selon les bonnes pratiques REST, elle propose des endpoints intuitifs, des réponses JSON structurées et la prise en charge de la pagination, des filtres et du tri.

✓Base URL: https://api.praxyo.com/v1
✓Format des réponses : JSON
✓Authentification : OAuth 2.0 et clé API
✓Versionnage : via le chemin d’URL (/v1, /v2)

API REST Praxyo

AUTENTICAZIONE

Authentication

Deux modes d’authentification pour chaque besoin.

API Key

Idéal pour les intégrations de serveur à serveur. Générez une clé API depuis les Paramètres de votre compte et incluez-la dans l’en-tête de chaque requête.

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

OAuth 2.0

Pour les applications agissant au nom d’un utilisateur. Prend en charge le flux Authorization Code avec 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

Accédez à toutes les ressources de la plateforme via des 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

Exemple de réponse

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

Afin de garantir la stabilité du service, les API sont soumises à des limites d’utilisation.

🚀

Free

100

requêtes / heure

⚡

Professional

1.000

requêtes / heure

🌟

Enterprise

10.000

requêtes / heure

Les en-têtes de réponse incluent des informations sur la limitation de débit :

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

SDK

SDK Disponibili

Bibliothèques officielles pour les langages les plus répandus.

💻

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

Recevez des notifications en temps réel lorsque des événements se produisent sur la plateforme.

Eventi Disponibili

✓project.created — Nouveau projet créé
✓task.created — Nouvelle tâche créée
✓task.completed — Tâche terminée
✓task.assigned — Tâche assignée
✓time_entry.created — Saisie de temps
✓expense.created — Dépense enregistrée

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

Une API puissante et bien documentée

Authentication

API Key

OAuth 2.0

Principali Endpoint

Progetti

Attività

Time Tracking

Exemple de réponse

Rate Limiting

Free

Professional

Enterprise

SDK Disponibili

JavaScript / TypeScript

Python

C# / .NET

Java / Kotlin

Webhook

Eventi Disponibili

Esempio Payload

Prêt à transformer votre façon de travailler ?