Her finner du informasjon om hvordan API kan benyttes for å hente ut timer fra Capitech for gjenbruk i andre systemer.
I korte trekk
- En må først logge på med en gyldig bruker med tilgang til API og hente ut et accessToken
Dette gjøres mot /api/public/v1/Access/login - Kjør en request mot API for timer med ønskede parameter for f. eks datointervall, klient (selskap) og evt. andr kriterier.
Dette gjøres mot api/public/v1/Time/getTimeTransactions
TimeAPI - getTimeTransaction
Beskrivelse av Request parametere
En kan få detaljert informasjon og eksempler via mouseover på hhv. request parameter og AP datasett i API oversikten
| Parameter | Påkrevd | Beskrivelse | Merknad |
|---|---|---|---|
| accessToken | Ja | Token fra Login. | Kreves for å få svar på API request |
| clientId | Ja | Klientnummer for hvilket firma en skal hente timer på | |
| fromDate | Ja | Fradato for ønsket periode i format 'yyyy-mm-dd' | Fra og med |
| toDate | Ja | Tildato for ønsket periode i format 'yyyy-mm-dd' | Til og med |
| approvedLevelFilter | Nei | Filter for å avgrense til kun godkjente timer Vanligvis benyttes nivå 1 Om flere nivå benyttes kan en spørre på f. eks nivå 2 osv.. | Om ikke angitt får en alle timer uavhengig av godkjenning. |
| employeeIdFilter | Nei | Filter for å angi evt. en eller flere ansattnr en ønsker å avgrense på. | |
| departmentIdFilter | Nei | Filter for å angi evt. en eller flere avdelingsnr en ønsker å avgrense på. | |
| taskIdFilter | Nei | Filter for å angi evt. en eller flere arbeidsoppgavenr en ønsker å avgrense på. | Bør kun benyttes sammen med avgrensning på en avdeling da arbeidsoppgavenr er en subdimensjon til avdeling. (Og samme nr på arbeidsoppgave kan i praksis være ulike oppgaver på ulike avdelinger) |
| orderIdFilter | Nei | Filter for å angi evt. en eller flere ordrenr en ønsker å avgrense på. | |
| dutyIdFilter | Nei | Filter for å angi evt. en eller flere Flow vakt id'er en ønsker å avgrense på. | NB Id på vakt er et autogenerert løpenr som ikke vises i vaktregister brukergrensesnitt. Dette filteret er kun for spesiell bruk. |
| projectIdFilter | Nei | Filter for å angi evt. en eller flere prosjektnr en ønsker å avgrense på. | |
| subProjectIdFilter | Nei | Filter for å angi evt. en eller flere underprosjektnr en ønsker å avgrense på. | Bør kun benyttes sammen med avgrensning på ett prosjekt da underprosjektnr er en subdimensjon til prosjekt. (Og samme nr på underprosjekt kan i praksis være ulike underprosjekt på ulike prosjekt) |
| projectPhaseIdFilter | Nei | Filter for å angi evt. en eller flere fasenr en ønsker å avgrense på. | Bør kun benyttes sammen med avgrensning på ett prosjekt og ett underprosjekt da fasenr er en subdimensjon til underprosjekt. (Og samme fasenr kan i praksis være ulike faser på ulike prosjekt / underprosjekt) |
| freeDimension1Filter | Nei | Filter for å angi evt. en eller flere fri dimensjon 1 nr en ønsker å avgrense på. | Fri dimensjon 1 er en dimensjon som kan aktiveres og gis navn iht. kundens behov. |
Visste du at ....