API-dokumentaatio

Shifton-API:n yhdistäminen ja käyttö

Shifton API antaa sinulle pääsyn kaikkiin alustan keskeisiin ominaisuuksiin — aikataulun hallinnasta ulkoisiin HRpalkanlaskenta, , ja analytiikkajärjestelmiinAPI:n avulla voit automatisoida prosesseja ja yhdistää Shiftonin yrityksesi sisäisiin palveluihin..
API-dokumentaatio


Tukemme kattaa kaksi dokumentaatioversiota:

Vanha dokumentaatio

  • 📄 — edellinen version API-viite (edelleen tuettu olemassa oleville integraatioille):https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/
    👉 Uusi dokumentaatio

  • 🚀 — API:n nykyinen versio, jossa on päivitetty rakenne ja uusimmat menetelmät: https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/
    👉Aloittaminen


Hanki API-avain

Luo

API-avainyrityksesi asetuksissa Shifton-alustalla..
Autentikointi tapahtuu otsikon kautta:

Authorization: Bearer {your_api_key}

Tee ensimmäinen pyyntösi

Esimerkiksi, hakeaksesi työntekijälistan:

GET /api/v1/employees
Host: api2.shifton.com
Authorization: Bearer {your_api_key}

Esimerkkivastaus:

{
"data": [
{
"id": 101,
"name": "Alice Johnson",
"position": "HR Manager"
},
{
"id": 102,
"name": "Bob Smith",
"position": "Cashier"
}
]
}

Integroi API työnkulkuihisi

  • Luo ja muokkaa vuoroja automaattisesti

  • Hallinnoi lomapyyntöjä ja sairauslomia

  • Vie tietoja palkanlaskentajärjestelmiin

  • Rakenna mukautettuja kojelautoja ja raportteja


Ydin-API-ominaisuudet

  • Työntekijät – lisää, muokkaa ja hallinnoi rooleja

  • Aikataulut – luo, säädä vuoroja, suunnittele työtä

  • Vapaa-aika ja poissaolot – hallinnoi loma- ja sairauslupapyyntöjä

  • Raportointi – vie aika-, palkka- ja läsnäolotiedot


Virhekoodit

Shifton API käyttää standardoituja HTTP-tilakoodeja:

  • 200 – Pyyntö onnistui

  • 201 – Objekti luotu onnistuneesti

  • 400 – Virheelliset parametrit

  • 401 – Valtuutusvirhe (virheellinen API-avain)

  • 403 – Pääsy estetty

  • 404 – Resurssia ei löydy

  • 500 – Palvelinvirhe


Käyttövinkit

  • Käytä aina uutta API-versiota uuteen integraatioon

  • Käytä Postmania tai curl:ää testaukseen

  • Noudata nopeusrajoja, jotta et joudu estetyksi

  • Päivitä integraatiot, jotka edelleen tukeutuvat vanhaan dokumentaatioon


Jaa tämä postaus