Documentație API

Conectarea și lucrul cu API-ul Shifton

API-ul Shifton îți oferă acces la toate funcționalitățile cheie ale platformei — de la gestionarea programelor la integrarea cu resurse umane, salarii, și sisteme de analiză.
Folosește API-ul pentru a automatiza procesele și a conecta Shifton cu serviciile interne ale companiei tale.

Documentația API

Oferim suport pentru două versiuni ale documentației noastre:

• 📄 Documentație veche — versiunea anterioară a referinței API (încă suportată pentru integrările existente):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Documentație nouă — versiunea actuală a API-ului cu o structură actualizată și cele mai recente metode:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Începutul utilizării

Obține un Cheie API

În setările companiei tale pe platforma Shifton, generează o cheie API.
Autorizarea se face prin header:

Fă prima ta cerere

De exemplu, pentru a obține o listă cu angajații:

Exemplu de răspuns:

Integrarea API-ului în fluxurile tale de lucru

• Creează și modifică automat turele

• Gestionează cererile de concediu și concediu medical

• Exportă date către sistemele de salarizare

• Construiește tablouri de bord și rapoarte personalizate

Capabilități API de bază

• Angajați – adăugare, editare și gestionare roluri

• Programe – creare, ajustare ture, planificare muncii

• Concedii și Absențe – gestionare cereri de concediu și concediu medical

• Raportare – export date timp, salarizare și prezență

Coduri de eroare

API-ul Shifton utilizează coduri de stare HTTP standard:

• 200 — Cerere reușită

• 201 — Obiect creat cu succes

• 400 — Parametri invalizi

• 401 — Eroare de autorizare (cheie API invalidă)

• 403 — Acces interzis

• 404 — Resursă negăsită

• 500 — Eroare de server

Sfaturi de utilizare

• Folosiți întotdeauna noua versiune API pentru noi integrări

• Folosiți Postman sau curl pentru testare

• Respectați limitele de rată pentru a evita blocarea

• Actualizați integrările care încă se bazează pe documentația veche