API i integracje

Zintegruj Praxyo ze swoimi narzędziami i zautomatyzuj przepływy pracy dzięki naszemu kompletnemu REST API.

REST API

Potężne i dobrze udokumentowane API

REST API Praxyo umożliwia programistyczny dostęp do wszystkich danych i funkcji platformy. Zaprojektowane zgodnie z najlepszymi praktykami REST, oferuje intuicyjne endpointy, ustrukturyzowane odpowiedzi JSON oraz obsługę paginacji, filtrowania i sortowania.

  • ✓Base URL: https://api.praxyo.com/v1
  • ✓Format odpowiedzi: JSON
  • ✓Uwierzytelnianie: OAuth 2.0 i klucz API
  • ✓Wersjonowanie: przez ścieżkę URL (/v1, /v2)
API REST Praxyo
AUTENTICAZIONE

Authentication

Dwie metody uwierzytelniania na każdą potrzebę.

API Key

Idealne do integracji serwer–serwer. Wygeneruj klucz API w Ustawieniach swojego konta i dodaj go w nagłówku każdego żądania.

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

OAuth 2.0

Dla aplikacji działających w imieniu użytkownika. Obsługuje przepływ Authorization Code z 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

Uzyskaj dostęp do wszystkich zasobów platformy przez endpointy 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

Przykładowa odpowiedź

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

Aby zapewnić stabilność usługi, API podlegają limitom użycia.

🚀

Free

100

żądań / godz.

⚡

Professional

1.000

żądań / godz.

🌟

Enterprise

10.000

żądań / godz.

Nagłówki odpowiedzi zawierają informacje o limitach zapytań (rate limiting):

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

SDK Disponibili

Oficjalne biblioteki dla najpopularniejszych języków.

💻

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

Otrzymuj powiadomienia w czasie rzeczywistym, gdy na platformie wystąpią zdarzenia.

Eventi Disponibili

  • ✓project.created — Utworzono nowy projekt
  • ✓task.created — Utworzono nowe zadanie
  • ✓task.completed — Zadanie ukończone
  • ✓task.assigned — Zadanie przypisane
  • ✓time_entry.created — Rejestracja czasu
  • ✓expense.created — Wydatek zarejestrowany

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

Gotowy, by zmienić sposób pracy?

Dołącz do tysięcy zespołów, które używają Praxyo do inteligentniejszego zarządzania projektami.