Přeskočit na hlavní obsah

Endpointy

Přehled hlavních API endpointů s příklady použití.

Time Entries (záznamy práce)​

Získání seznamu​

curl -H "X-API-Key: vas_klic" \
  "https://app.mujvykaz.cz/api/v1/time-entries?from=2026-03-01&to=2026-03-31"

Query parametry: from, to, project_id, status, page, per_page.

Vytvoření záznamu​

curl -X POST -H "X-API-Key: vas_klic" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 1, "date": "2026-03-27", "hours": 2.5, "description": "API integrace"}' \
  https://app.mujvykaz.cz/api/v1/time-entries

Povinná pole: project_id, date, hours.

Projects (projekty)​

Získání seznamu​

curl -H "X-API-Key: vas_klic" \
  https://app.mujvykaz.cz/api/v1/projects

Vytvoření projektu​

curl -X POST -H "X-API-Key: vas_klic" \
  -H "Content-Type: application/json" \
  -d '{"name": "Nový web", "client_id": 1, "hourly_rate": 1500, "billable": true}' \
  https://app.mujvykaz.cz/api/v1/projects

Povinná pole: name, client_id.

Clients (klienti)​

Získání seznamu​

curl -H "X-API-Key: vas_klic" \
  https://app.mujvykaz.cz/api/v1/clients

Vytvoření klienta​

curl -X POST -H "X-API-Key: vas_klic" \
  -H "Content-Type: application/json" \
  -d '{"name": "Firma s.r.o.", "ico": "12345678", "currency": "CZK"}' \
  https://app.mujvykaz.cz/api/v1/clients

Povinná pole: name.

Invoices (faktury)​

Získání seznamu​

curl -H "X-API-Key: vas_klic" \
  "https://app.mujvykaz.cz/api/v1/invoices?from=2026-01-01&to=2026-03-31"

Vytvoření faktury​

curl -X POST -H "X-API-Key: vas_klic" \
  -H "Content-Type: application/json" \
  -d '{"client_id": 1, "time_entry_ids": [10, 11, 12]}' \
  https://app.mujvykaz.cz/api/v1/invoices

Povinná pole: client_id, time_entry_ids.

Users (uživatelé)​

Můj profil​

curl -H "X-API-Key: vas_klic" \
  https://app.mujvykaz.cz/api/v1/users/me

Moje statistiky​

curl -H "X-API-Key: vas_klic" \
  https://app.mujvykaz.cz/api/v1/users/stats

Stránkování​

Seznamové endpointy podporují stránkování:

ParametrVýchozíPopis
page1Číslo stránky
per_page25Záznamů na stránku (max 100)

Metadata stránkování jsou v poli meta odpovědi.