Puoi usare quest'API per interagire con il nostro sistema App Rilevazione Presenze.
\nLe API prevedono un sistema di pagamento a consumo. Per maggiori informazioni visita la pagina API dal tuo pannello di amministrazione App Rilevazione Presenze.
\nPer qualsiasi informazione ti inviato a contattarci ad assistenza@libemax.com oppure al numero 0350667180
\nScarica il file di definizione secondo la specifica OpenAPI v3.0. Scarica
\nOppure scarica la raccolta di chiamate Postman. Scarica
\nDopo aver importato la raccolta in Postman:
\naprire i dettagli della raccolta
\ncliccare su variables per accedere alla sezione variabili della raccolta (collection variables)
\nmodificare il valore delle variabili account e auth_value (maggiori dettagli più avanti in questa guida) e cliccare su salva
\nL'url base è: https://{account}.libemax.com/app-timbrature
\nSostituire {account} col nome del vostro account App Rilevazione Presenze.
\nOgni path prevede due parametri: lingua e versione api. Le lingue disponibili sono \"it\" e \"en\". Verranno tradotte soltanto eventuali stringhe di messaggio. I nomi dei parametri non sono disponibili in inglese.
\nL'unica versione API disponibile al momento è la \"v3\".
\nEsempio: https://{account}.libemax.com/app-timbrature/it/api/v3/timbratura/timbratura_elenco
\nPer poter utilizzare le nostre API avrai bisogno di una api key. Visita la sezione API sul tuo pannello App Rilevazione Presenze per generare/modificare la tua api key. Dovrai inviare l'api key generata nell'header x-api-key di ogni richiesta. Ti invitiamo a non condividere a terzi la tua api key.
\nLe nostre API accettano richieste in formato x-ww-urlencoded. Le risposte sono formattate come JSON.
\nLe risposte delle api contengono un parametro di tipo intero \"ritorno\".
\nIndica lo \"stato\" della risposta. Se si sono verificati errori o l'operazione richiesta non è andata a buon fine ritorno sarà uguale a zero. Altrimenti sarà uguale ad uno.
\nSono impostate due limitazioni:
\n30 chiamate al minuto.
\n500 chiamate ogni ora.
\nSe questi limiti vengono superati il server risponderà con un messaggio di errore. Vi preghiamo di tener conto di questi limiti quando implementate integrazioni automatiche con App Rilevazione Presenze
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"14878259","collectionId":"a9d156ad-4997-4484-a829-9ed5e6961278","publishedId":"2s83zgtjQJ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"cccccF","highlight":"d4155d"},"publishDate":"2025-03-14T14:48:08.000Z"},"item":[{"name":"Timbrature","item":[{"name":"Timbrature Elenco","id":"302d0a24-cc7b-4d3b-9411-0a74fec51c71","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/x-www-form-urlencoded"},{"key":"Accept","value":"application/json"}],"body":{"mode":"urlencoded","urlencoded":[{"key":"da","value":"(Required) Data inizio range in formato aaaa-mm-gg (Y-m-d)
\n"},{"key":"a","value":"(Required) Data fine range in formato aaaa-mm-gg (Y-m-d)
\n"},{"key":"tipo","value":"2 - timbrature (macrotimbrature); 1 - per sottotimbrature. Default: 2
\n","disabled":true},{"key":"dipendente","value":"Codice gestionale del dipendente
\n","disabled":true},{"key":"cliente","value":"Codice gestionale del cliente
\n","disabled":true},{"key":"attivita","value":"Codice gestionale attivita
\n","disabled":true},{"key":"dipendenti_con_codice","value":"0 tutti i dipendenti; 1 - solo dipendenti con codice gestionale compilato
\n","disabled":true},{"key":"formato","value":"1 orari in sessantesimi; 2 - orari in centesimi. Default: 1
\n","disabled":true},{"key":"ultima_modifica_da","value":"(Required) Data ultima modifica inizio range in formato aaaa-mm-gg (Y-m-d)
\n","type":"text","uuid":"75e33f02-b169-4102-ae73-70c6a1375457","disabled":true},{"key":"ultima_modifica_a","value":"(Required) Data ultima modifica fine range in formato aaaa-mm-gg (Y-m-d)
\n","type":"text","uuid":"e3ddde28-8334-4715-a012-b6fd41d00dde","disabled":true}]},"url":"https://{account}.libemax.com/app-timbrature/:lang/api/:api_version/timbratura/timbratura_elenco","description":"Ritorna una lista delle timbrature. È possibile utilizzare i parametri della richiesta per filtrare i risultati.
\nIl filtro sulle date è obbligatorio ma è possibile usare la data della timbratura con i parametri da e a oppure la data di ultima modifica con i parametri ultima_modifica_da e ultima_modifica_a.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{tua_api_key}"}]},"isInherited":true,"source":{"_postman_id":"a9d156ad-4997-4484-a829-9ed5e6961278","id":"a9d156ad-4997-4484-a829-9ed5e6961278","name":"Documentazione - App Rilevazione Presenze","type":"collection"}},"urlObject":{"protocol":"https","path":["app-timbrature",":lang","api",":api_version","timbratura","timbratura_elenco"],"host":["{account}","libemax","com"],"query":[],"variable":[{"description":{"content":"(Required) Lingua - it|en
\n","type":"text/plain"},"type":"any","value":"it","key":"lang"},{"description":{"content":"(Required) Versione API - v3
\n","type":"text/plain"},"type":"any","value":"v3","key":"api_version"}]}},"response":[{"id":"a5c6ae80-82cd-48e5-94ac-0c8de9d1d80e","name":"Lista delle timbrature","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"Ritorna la lista delle attività.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{tua_api_key}"}]},"isInherited":true,"source":{"_postman_id":"a9d156ad-4997-4484-a829-9ed5e6961278","id":"a9d156ad-4997-4484-a829-9ed5e6961278","name":"Documentazione - App Rilevazione Presenze","type":"collection"}},"urlObject":{"protocol":"https","path":["app-timbrature",":lang","api",":api_version","attivita","attivita_elenco"],"host":["{account}","libemax","com"],"query":[],"variable":[{"description":{"content":"(Required) Lingua - it|en
\n","type":"text/plain"},"type":"any","value":"it","key":"lang"},{"description":{"content":"(Required) Versione API - v3
\n","type":"text/plain"},"type":"any","value":"v3","key":"api_version"}]}},"response":[{"id":"59b4d0b1-31b1-4d73-b288-9aec0c2a2a9f","name":"Lista delle attivita","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"(Required) Descrizione/nome dell'attivita
\n"},{"key":"archiviato","value":"1 se attivita archiviata, 0 se attivita attiva
\n","disabled":true},{"key":"codice_gestionale","value":"Codice identificativo dell'attivita. Se è già presente un'attivita con questo codice verrà fatto un update dei dati esistenti altrimenti verrà inserito un nuovo record
\n","disabled":true}]},"url":"https://{account}.libemax.com/app-timbrature/:lang/api/:api_version/attivita/attivita_sincronizza","description":"Inserisce o modifica un'attivita. Se viene trovata un attività con quel codice gestionale viene fatto un update del dato esistente altrimenti viene inserito un nuovo record.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"x-api-key"},{"key":"value","value":"{tua_api_key}"}]},"isInherited":true,"source":{"_postman_id":"a9d156ad-4997-4484-a829-9ed5e6961278","id":"a9d156ad-4997-4484-a829-9ed5e6961278","name":"Documentazione - App Rilevazione Presenze","type":"collection"}},"urlObject":{"protocol":"https","path":["app-timbrature",":lang","api",":api_version","attivita","attivita_sincronizza"],"host":["{account}","libemax","com"],"query":[],"variable":[{"description":{"content":"(Required) Lingua - it|en
\n","type":"text/plain"},"type":"any","value":"it","key":"lang"},{"description":{"content":"(Required) Versione API - v3
\n","type":"text/plain"},"type":"any","value":"v3","key":"api_version"}]}},"response":[{"id":"45d1e689-77b8-40eb-80e9-809863f4f3f7","name":"Operazione eseguita con successo","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":"