← API documentatie

Timers API

Inhoud
GET /timers

Lopende timers ophalen

Geeft uw lopende timers terug, nieuwste eerst.

Verzoek
curl "https://financial.gyvex.com/api/timers" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"
POST /timer/start

Timer starten

Start een timer op dit moment, optioneel voor een project en/of klant.

Parameter Beschrijving
project_id, customer_id ID van een van uw projecten of klanten, optioneel.
Verzoek
curl -X POST "https://financial.gyvex.com/api/timer/start" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"project_id": 4}'
POST /timer/{id}/stop

Timer stoppen

Stopt de timer en zet die om in een factureerbare urenregistratie. Zonder hours wordt de verstreken tijd gebruikt. De timer wordt verwijderd en de nieuwe urenregistratie staat in het antwoord (status 201).

Parameter Beschrijving
hours Aantal uren, optioneel.
description Omschrijving, optioneel.
billable Factureerbaar, standaard true.
Verzoek
curl -X POST "https://financial.gyvex.com/api/timer/9/stop" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL" \
  -H "Content-Type: application/json" \
  -d '{"description": "Ontwerp homepage"}'
DELETE /timer/{id}

Timer verwijderen

Verwijdert de timer zonder uren te registreren. Bij succes volgt status 204.

Verzoek
curl -X DELETE "https://financial.gyvex.com/api/timer/9" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer UW_API_SLEUTEL"

Hulp nodig bij uw koppeling?

Maak een ticket aan via "Mijn Gyvex" in uw dashboard. Met Premium krijgt u priority support, met reactie binnen 24 uur.