Garatzaileentzat

Tiemioren APIa

Irakurri zure enpresaren lanaldi-erregistroak zure tresnetatik: nominen kalkulu-orri bat, txosten bat, AA laguntzaile bat. APIa irakurtzeko soilik da, beraz aplikaziotik kanpo ezerk ezin du erregistroa aldatu.

Zer egiten duen eta zer ez

Zure taldea, pertsona bakoitzaren orduak egunez egun, egun bakoitzeko fitxaketak, zuzenketak eta hash-katea irakurtzen ditu.
Ezin du fitxatu, ezer aldatu edo onartu. Fitxaketa langileak egiten du, eta aldaketa bakoitza pertsona batek onartzen du: horrek ematen dio erregistroari froga-balioa.
Ezin ditu erregistro-orriak deskargatu: deskarga bakoitza nori zer eman zaion frogatzeko idatzita geratzen da, beraz aplikazioan egiten da.
Gako batek ez du inoiz ikusten pertsona baten NAN/AIZ, posta elektronikoa edo telefonoa, ezta ordu-oharren testua ere. Zuzenketen arrazoiak bai, erregistroaren parte direlako.
Ez dago webhookik. Aldaketak ikusteko, irakurri berriro.

Lortu gako bat

Sartu enpresaren titular gisa eta ireki Enpresa orria.
API gakoak atalean, jarri izena gakoari eta sortu.
Kopiatu une horretan: behin bakarrik erakusten da. Hash bat baino ez dugu gordetzen.
Bidali dei bakoitzean honela: Authorization: Bearer <gakoa>. Gorde zure zerbitzarian, inoiz ez web-orri edo aplikazio batean: gakoa duenak zure langileen erregistroak irakur ditzake.
Gako bat nahi duzunean ezezta dezakezu. Titularrak mezu elektroniko bat jasotzen du gako berri bakoitzeko.

Zure lehen deia

curl -H "Authorization: Bearer tmk_your_key" \
  "https://tiemio.com/api/employer/month?month=2026-09"

Erantzunak pertsona eta egun bakoitzeko lan egindako milisegundoak ematen ditu, onartutako zuzenketak aplikatuta. 0 indizea hilaren 1a da.

{
  "month": "2026-09",
  "today": "2026-10-30",
  "timeZone": "Europe/Madrid",
  "days": 30,
  "people": [
    {
      "employmentId": "emp_01",
      "personId": "usr_01",
      "name": "Ana García",
      "from": "2026-01-12",
      "until": null,
      "workedMs": [28800000, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
      "flagged": [false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false, false]
    }
  ]
}

Bost bideak

GET /api/employer: Enpresa eta bertako jendea, pertsona aktibo bakoitzaren uneko egoerarekin. Erabili hemengo lan-harremanaren ida (employment) hurrengo bideetan.
GET /api/employer/month?month=YYYY-MM: Hilabete batean pertsona eta egun bakoitzeko lan egindako denbora, eta zein egun geratzen diren pertsonaren ordutegitik kanpo.
GET /api/employer/employments/{id}/day?date=YYYY-MM-DD: Pertsona baten egun bat: fitxaketa bakoitza, gailuko orduarekin, jasotze-orduarekin, konexiorik gabe itxaron zuen ala ez, eta egun horretan erabakitako zuzenketekin.
GET /api/employer/corrections: Enpresaren zuzenketak: nork eskatu zuen, nork erabaki zuen, noiz eta zergatik. Gehitu ?status=pending edo ?employment=<id> mugatzeko.
GET /api/employer/employments/{id}/chain: Fitxaketa bakoitza hash-a kalkulatu zen bezala, 500 orrialde bakoitzean, zure tresnak katea berriro kalkula dezan. Gehitu ?after=<next> hurrengo orrialderako eta ?kind=corrections zuzenketen lerroetarako.

Hilabete bat irakurtzea mugara iritsi gabe

Guztizkoetarako, month dei batek talde osoa hartzen du.
Sarrera- eta irteera-orduek day dei bat behar dute pertsona eta egun bakoitzeko. 20 pertsonarekin eta 31 egunekin 620 dei dira, 11 minutu inguru mugan, beraz bereiz itzazu.
Egunak enpresaren ordu-eremuan mozten dira, erantzun bakoitzean adierazita. Uneak UTCn daude.
Egin behin, hilabetea itxi ondoren, etengabe kontsultatu beharrean.

Mugak eta erroreak

60 eskaera minutuan, gako bakoitzeko eta bezeroaren helbide bakoitzeko. Hortik gora: 429, rate_limited kodearekin eta Retry-After: 60. Itxaron eta saiatu berriro.
401 bad_api_key: gakoa ezezaguna da edo ezeztatuta dago.
400 bad_request: gaizki osatutako hilabetea, data edo parametroa, edo etorkizuneko data.
404, day eta chain bideetan: pertsona hori ez dago zure enpresan. corrections bidean, zurea ez den id batek zerrenda hutsa itzultzen du.
500: zerbaitek huts egin du gure aldetik, eta erantzunak agian ez du koderik. Saiatu berriro.
Erroreak { error, code } dira. Erabili kodea: testua alda daiteke.
Gako batek irakurtzen jarraitzen du zure plana iraungita ere. Ezeztatzen denean, negozioa ixten denean edo sortzailea titular izateari uzten dionean gelditzen da.

Zer mantentzen den egonkor

Erreferentziako eremuak bakarrik bermatzen dira. Bideek beste eremu batzuk ere itzultzen dituzte; ez oinarritu haietan.
Dokumentatutako eremu bat ez da kentzen edo aldatzen. Berriak ager daitezke, beraz ez ikusi egin ezagutzen ez dituzunei.

Probatu konturik gabe

Probak demo-enpresa bat irekitzen du, pertsona fikziozkoekin eta asteetako historiarekin. Erantzunak titular-token bat ematen dizu, bost bide berberetan funtzionatzen duena, proba-zerbitzarian, 24 orduz.

curl -X POST https://testdrive.tiemio.com/api/testdrive

Desberdintasun bat: probako titular-tokena saio bat da, ez API gako bat, beraz gako batek ikusten ez dituen kontaktu-datuak eta oharrak ere ikusten ditu.