Easpórtáil do shonraí

Easpórtálacha scarbhileoige ó na deaiseanna, agus eochracha API le haghaidh sliochtanna uathoibrithe.

Tá dhá bhealach le sonraí a fháil amach: íoslódáil ó dheais iad, nó tarraing go ríomhchláraithe iad le heochair API.

Easpórtáil scarbhileoige

Tairgeann gach deais Easpórtáil CSV agus Easpórtáil Excel. Clúdaíonn an íoslódáil an scála agus an tréimhse atá ar an scáileán faoi láthair, mar sin socraigh an roghnóir tréimhse — Inniu, An tseachtain seo, Téarma nó Bliain scoile — sula ndéanann tú easpórtáil.

Is é seo an bealach ceart le haghaidh tuairisc cláir, páipéar boird, nó aon rud a osclóidh tú in Excel ar aon nós.

Eochracha API

Le haghaidh sliocht athfhillteach isteach i do chóras tuairiscithe féin, bain úsáid as eochair API. Ní féidir ach le Riarthóirí Comhairle iad a eisiúint, ó Eochracha API.

Eochair a eisiúint

1. Oscail Eochracha API.
2. Cruthaigh eochair, scálaithe do do chomhairle nó d'aon scoil amháin.
3. Cóipeáil láithreach í.

Taispeántar an eochair duit uair amháin, nuair a chruthaítear í. Ní stóráiltear ach hais di, mar sin ní féidir í a aisghabháil ná a thaispeáint arís. Má chailleann tú í, cúlghair í agus eisigh ceann nua.

Eochair a láimhseáil

Is dintiúr é eochair a bhfuil rochtain léimh sheasta aici ar shonraí do chláir. Faoi na téarmaí ar aontaigh tú leo:

• stóráil i mbainisteoir rún nó a chomhionann í — riamh i scarbhileog, i ríomhphost, i dtiomántán comhroinnte ná i stór cóid;
• bain úsáid aisti don scála ar eisíodh í dó amháin, agus chun críocha cláir chomhairle nó scoile amháin;
• cúlghair go pras í nuair a dhíchoimisiúnaítear an comhtháthú a bhfreastalaíonn sí air, nó má d'fhéadfaí í a nochtadh.

Eisigh eochair amháin in aghaidh an chomhtháthaithe. Ní féidir eochracha comhroinnte a chúlghairm gan gach rud a bhriseadh in aon iarraidh, agus ní insíonn siad aon rud duit faoi cé a bhí á n-úsáid.

An API a ghlaoch

GET /api/v1/export
Authorization: Bearer <d'eochair>

Sampla:

curl -H "Authorization: Bearer $ATT_KEY" \
  "https://tapin.ie/api/v1/export?scope=council&from=2026-09-01&to=2026-09-30"

Ní féidir le heochair léamh ach laistigh dá scála féin. Má iarrtar comhairle nó scoil nár eisíodh an eochair di, tugtar 403 ar ais, ní sonraí.

Tá an tagairt API (i mBéarla amháin) ag liostú gach críochphointe is féidir le heochair a ghlaoch, lena n-áirítear figiúirí an chlár ionstraimí, agus na réimsí a thugann gach ceann ar ais. Is féidir an sonraíocht OpenAPI chéanna a íoslódáil agus a iompórtáil in uirlisí mar Postman.

Cad a thagann ar ais

JSON, comhiomlánaithe de réir dáta, scoile, ranga agus modha. Ní thaispeántar aon dalta aonair — deir an freagra féin é:

{
  "meta": {
    "scope": "council",
    "id": "…",
    "from": "2026-09-01",
    "to": "2026-09-30",
    "totalRecords": 1284,
    "note": "Data is aggregated by date/school/class/mode. No individual student identifiers are included."
  },
  "data": [
    {
      "date": "2026-09-01",
      "school": "St. Brigid's NS",
      "className": "3rd Class A",
      "yearGroup": "3rd",
      "mode": "WALK",
      "count": 18
    }
  ]
}

Ró amháin in aghaidh an dáta, an ranga agus an mhodha, le count de thurais. Is ceann de WALK, CYCLE, SCOOTER, PARK_STRIDE, BUS, RAIL, CAR_SHARE, CAR é mode.

Rátaí a ríomh tú féin

Tugann an easpórtáil comhairimh amha duit, ní rátaí. Má tá tú ag atáirgeadh an ráta taistil ghníomhaigh a thaispeánann na deaiseanna, cuimhnigh go gcuntar gach modh seachas CAR — féach do dheaiseanna a léamh le haghaidh cén fáth a bhfuil an t-idirdhealú sin tábhachtach i dtuairisc.

Níl CO₂ sábháilte ná km siúlta / rothlaithe san easpórtáil mar nach stóráiltear iad — múnlaítear iad ó chomhairimh turas ag baint úsáide as meánturas 2 km agus 0.17 kg CO₂ in aghaidh an km. Cuir na fachtóirí céanna i bhfeidhm más gá duit iad a atáirgeadh.

Cóid fhreagartha

Nótaí praiticiúla

• Tarraing an mhaidin dár gcionn. Is féidir turais a leasú go dtí 23:59 ar an lá a taifeadadh iad, mar sin d'fhéadfadh tarraingt an lae chéanna easaontú leis an deais níos déanaí.
• Iarr dátaí from agus to follasacha. Bogann an réamhshocrú 30 lá fút.
• Tá sé sábháilte tréimhse san am atá caite a tharraingt arís agus tugann sé na figiúirí céanna ar ais.

Fós i bhfostú? Seol ríomhphost chuig ár bhfoireann tacaíochta.