Files.com (anteprima)

Il connettore Files.com offre un'integrazione diretta ad alte prestazioni per Files.com per flussi di lavoro e integrazioni automatizzati nella piattaforma di automazione di Microsoft.

Questo connettore è disponibile nei prodotti e nelle aree seguenti:

Servizio	Class	Regions
Copilot Studio	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
App per la logica	Normale	Tutte le aree di App per la logica , ad eccezione delle seguenti: - Aree di Azure per enti pubblici - Aree di Azure Cina - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Apps	Di alta qualità	Tutte le aree di Power Apps , ad eccezione dei seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)
Power Automate	Di alta qualità	Tutte le aree di Power Automate , ad eccezione delle seguenti: - Governo degli Stati Uniti (GCC) - Us Government (GCC High) - China Cloud gestito da 21Vianet - Dipartimento della Difesa degli Stati Uniti (DoD)

Contatto
Nome	supporto Files.com
URL	https://www.files.com/contact
Email	support@files.com

Metadati del connettore
Editore	Files.com
Sito web	https://www.files.com/
Informativa sulla privacy	https://www.files.com/legal/privacy
Categorie	Contenuto e file;Operazioni IT

Files.com connettore Power Automate

Informazioni generali

Il connettore Files.com offre un'integrazione diretta e ad alte prestazioni per Files.com da Microsoft Power Automate e app per la logica di Azure. Files.com è la piattaforma MFT, SFTP e sicura nativa del cloud che sostituisce server legacy fragili con un'infrastruttura sicura e sempre attiva. Automatizzare i flussi di file cruciali, attraverso qualsiasi cloud, protocollo o partner, supportando la collaborazione umana ed eliminando il lavoro manuale.

Nota: questo connettore fornisce solo azioni e non include ancora trigger.

⸻

Prerequisiti

Prima di usare questo connettore, assicurarsi di avere: 1. Un account di Files.com valido con una chiave API. 2. Accedere a Microsoft Power Automate.

⸻

Authentication

Questo connettore usa l'autenticazione della chiave API. La chiave API può essere generata nell'account Files.com in:

Impostazioni → chiavi API → Crea chiave API.

Quando si configura il connettore, immettere l'host Files.com e la chiave API nei campi di autenticazione.

Esempio:

Host: chiave API aziendale: abc123456789...

Tutte le richieste vengono inviate a:

https://yourcompany.files.com/api/rest/v1/

⸻

Casi d'uso di esempio 1. Gestire utenti e gruppi Creare, aggiornare o disattivare gli utenti, assegnare ruoli e gestire le appartenenze ai gruppi direttamente tramite le azioni di Power Automate. 2. Automatizzare i flussi di lavoro del collegamento di condivisione (bundle) Generare collegamenti di condivisione per il recapito dei file, aggiungere destinatari, configurare notifiche o revocare automaticamente l'accesso. 3. Sincronizzare le cartelle dell'elenco dei metadati dei file, recuperare i metadati dei file e applicare la logica di automazione, ad esempio le modifiche alle autorizzazioni o l'assegnazione di tag. 4. Creare flussi di lavoro di provisioning utenti Integrare sistemi di gestione delle risorse umane o delle identità con Files.com per creare automaticamente utenti o aggiornare l'accesso quando si verificano modifiche. 5. Attivare la distribuzione dei documenti Combinare Files.com azioni con OneDrive o SharePoint per distribuire o archiviare i documenti in modo sicuro.

⸻

Support

Per assistenza tecnica o domande sulla configurazione del connettore, contattare Files.com supporto tecnico all'indirizzo https://www.files.com/contact

Per i problemi specifici di Power Automate, vedere la documentazione del connettore personalizzato di Microsoft.

⸻

Note legali

Questo connettore viene fornito da Files.com. Con questo connettore si accettano le condizioni per l'utilizzo del servizio Files.com e l'informativa sulla privacy.

Creazione di una connessione

Il connettore supporta i tipi di autenticazione seguenti:


Predefinita	Parametri per la creazione della connessione.	Tutte le aree geografiche	Non condivisibile

Predefinito

Applicabile: tutte le aree

Parametri per la creazione della connessione.

Questa non è una connessione condivisibile. Se l'app power viene condivisa con un altro utente, verrà richiesto a un altro utente di creare una nuova connessione in modo esplicito.

Nome	TIPO	Description	Obbligatorio
chiave_api	securestring	Il api_key per questa API	Vero

Limiti per la limitazione delle richieste

Nome	Chiamate	Periodo di rinnovo
Chiamate API per connessione	100	60 secondi

Azioni

Aggiorna collegamento condivisione	Aggiorna collegamento condivisione
Aggiornare la notifica del collegamento di condivisione	Aggiornare la notifica del collegamento di condivisione
Aggiornare un gruppo	Aggiornare un gruppo
Aggiornare un utente	Aggiornare un utente
Aggiornare un utente	Aggiornare un utente
Carica il file	Carica il file
Collegamenti di condivisione elenco	Collegamenti di condivisione elenco
Copia file o cartella	Copia file o cartella
Crea cartella	Crea cartella
Crea collegamento di condivisione	Crea collegamento di condivisione
Crea destinatario collegamento condivisione	Crea destinatario collegamento condivisione
Crea gruppo	Crea gruppo
Creare un nuovo account utente per il gruppo	Creare un nuovo account utente per il gruppo
Creare un utente	Creare un utente
Creare una notifica di collegamento di condivisione	Creare una notifica di collegamento di condivisione
Destinatari dei collegamenti di condivisione elenco	Destinatari dei collegamenti di condivisione elenco
Elenca gruppi	Elenca gruppi
Elenca utenti	Elenca utenti
Elencare cartelle per percorso	Elencare cartelle per percorso
Elencare i download dei collegamenti di condivisione	Elencare i download dei collegamenti di condivisione
Elencare le notifiche dei collegamenti di condivisione	Elencare le notifiche dei collegamenti di condivisione
Elimina collegamento condivisione	Elimina collegamento condivisione
Elimina file o cartella	Elimina file o cartella
Elimina notifica collegamento condivisione	Elimina notifica collegamento condivisione
Eliminare un gruppo	Eliminare un gruppo
Eliminazione di un utente.	Eliminazione di un utente.
List Share Link Registrations	List Share Link Registrations
Mostra collegamento di condivisione	Mostra collegamento di condivisione
Mostra gruppo	Mostra gruppo
Mostra notifica di condivisione collegamento	Mostra notifica di condivisione collegamento
Mostra utente	Mostra utente
Scaricare il file	Scaricare il file
Sposta file o cartella	Sposta file o cartella
Trova file o cartella in base al percorso	Trova file o cartella in base al percorso

Aggiorna collegamento condivisione

ID operazione:: PatchBundlesId

Aggiorna collegamento condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID bundle.
Scade all'ora	expires_at		date-time	Data/ora di scadenza del bundle

Restituisce

Nome	Percorso	Tipo	Descrizione
codice	code	string	Codice bundle. Questo codice costituisce la parte finale dell'URL pubblico.
color_left	color_left	string	Colore del collegamento e del pulsante della pagina
color_link	color_link	string	Colore del collegamento della barra superiore
color_text	color_text	string	Colore del collegamento e del pulsante della pagina
color_top	color_top	string	Colore di sfondo della barra superiore
color_top_text	color_top_text	string	Colore del testo della barra superiore
URL	url	string	URL pubblico del collegamento di condivisione
descrizione	description	string	Descrizione pubblica
scade_il	expires_at	string	Data o ora di scadenza del bundle
password_protected	password_protected	boolean	Questa password bundle è protetta?
permissions	permissions	string	Autorizzazioni che si applicano alle cartelle in questo collegamento di condivisione.
preview_only	preview_only	boolean
require_registration	require_registration	boolean	Mostra una pagina di registrazione che acquisisce il nome e l'indirizzo di posta elettronica del downloader?
require_share_recipient	require_share_recipient	boolean	Consentire l'accesso solo ai destinatari che hanno ricevuto esplicitamente la condivisione tramite un messaggio di posta elettronica inviato tramite l'interfaccia utente Files.com?
require_logout	require_logout	boolean	Se true, verrà nascosta la casella "Memorizzami" nella pagina Registrazione bundle, richiedendo che l'utente si disconnette e accinga a eseguire nuovamente l'accesso ogni volta che visitano la pagina.
clickwrap_body	clickwrap_body	string	Testo legale che deve essere accettato prima di accedere a Bundle.
id	form_field_set.id	integer	ID set di campi modulo
title	form_field_set.title	string	Titolo da visualizzare
form_layout	form_field_set.form_layout	array of integer	Layout del modulo
form_fields	form_field_set.form_fields	array of object	Campi modulo associati
items	form_field_set.form_fields	object
skip_name	form_field_set.skip_name	boolean	È possibile salvare eventuali InboxRegistrations o BundleRegistrations associati senza specificare il nome
skip_email	form_field_set.skip_email	boolean	Qualsiasi inboxRegistrations o BundleRegistrations associato può essere salvato senza fornire un messaggio di posta elettronica
skip_company	form_field_set.skip_company	boolean	Qualsiasi InboxRegistrations o BundleRegistrations associato può essere salvato senza fornire all'azienda
in_use	form_field_set.in_use	boolean	Il set di campi modulo è in uso da una cartella posta in arrivo o un bundle attivo o registrazione in arrivo o registrazione bundle
skip_name	skip_name	boolean	È possibile salvare bundleRegistrations senza specificare il nome?
skip_email	skip_email	boolean	È possibile salvare bundleRegistrations senza fornire un messaggio di posta elettronica?
start_access_on_date	start_access_on_date	string	Data in cui la condivisione inizierà ad essere accessibile. Se `nil` l'accesso viene concesso subito dopo la creazione.
skip_company	skip_company	boolean	È possibile salvare bundleRegistrations senza fornire un'azienda?
id	id	integer	ID bundle
creato_il	created_at	string	Bundle creato in data o ora
dont_separate_submissions_by_folder	dont_separate_submissions_by_folder	boolean	Non creare sottocartelle per i file caricati in questa condivisione. Nota: ci sono sottili problemi di sicurezza con consentire caricamenti anonimi da più utenti di vivere nella stessa cartella. Sconsigliamo vivamente l'uso di questa opzione a meno che non sia assolutamente necessario.
max_uses	max_uses	integer	Numero massimo di volte in cui è possibile accedere al bundle
nota	note	string	Nota interna bundle
path_template	path_template	string	Modello per la creazione di sottocartelle di invio. Può usare il nome, l'indirizzo di posta elettronica, l'indirizzo di posta elettronica, l'ip, la società, `strftime` le direttive e tutti i dati del modulo personalizzati.
path_template_time_zone	path_template_time_zone	string	Fuso orario da usare per il rendering dei timestamp nei modelli di percorso.
send_email_receipt_to_uploader	send_email_receipt_to_uploader	boolean	Inviare la ricevuta di recapito al caricatore. Nota: solo per la condivisione scrivibile
snapshot_id	snapshot_id	integer	ID dello snapshot contenente il contenuto del bundle.
ID_utente	user_id	integer	ID utente creator bundle
username	username	string	Nome utente creatore bundle
clickwrap_id	clickwrap_id	integer	ID del clickwrap da usare con questo bundle.
inbox_id	inbox_id	integer	ID della posta in arrivo associata, se disponibile.
nome	watermark_attachment.name	string	Nome dell'immagine
URI	watermark_attachment.uri	string	URI dell'immagine
watermark_value	watermark_value	object	Visualizzare in anteprima le impostazioni della filigrana applicate a tutti gli elementi del bundle. Usa le stesse chiavi di Behavior.value
has_inbox	has_inbox	boolean	Questo bundle ha una posta in arrivo associata?
dont_allow_folders_in_uploads	dont_allow_folders_in_uploads	boolean	È consigliabile impedire il caricamento delle cartelle?
Percorsi	paths	array of string	Elenco di percorsi in questo bundle. Per motivi di prestazioni, questo non viene fornito quando si elencano i bundle.
bundlepaths	bundlepaths	array of object	Elenco di bundlepath in questo bundle. Per motivi di prestazioni, questo non viene fornito quando si elencano i bundle.
items	bundlepaths	object

Aggiornare la notifica del collegamento di condivisione

ID operazione:: PatchBundleNotificationsId

Aggiornare la notifica del collegamento di condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID notifica bundle.
Notifica alla registrazione	notify_on_registration		boolean	Attiva la notifica del bundle quando si verifica un'azione di registrazione.
Notifica al caricamento	notify_on_upload		boolean	Attiva la notifica bundle quando si verifica un'azione di caricamento.

Restituisce

Nome	Percorso	Tipo	Descrizione
bundle_id	bundle_id	integer	ID bundle per la notifica
id	id	integer	ID notifica bundle
notify_on_registration	notify_on_registration	boolean	Attiva la notifica del bundle quando si verifica un'azione di registrazione.
notify_on_upload	notify_on_upload	boolean	Attiva la notifica bundle quando si verifica un'azione di caricamento.
notify_user_id	notify_user_id	integer	ID dell'utente da notificare.

Aggiornare un gruppo

ID operazione:: PatchGroupsId

Aggiornare un gruppo

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID gruppo.
ID amministratore	admin_ids		string	Elenco di ID utente amministratore del gruppo. Se inviato come stringa, deve essere delimitato da virgole.
Nome	name		string	Nome gruppo.
Note	notes		string	Raggruppa le note.
ID utente	user_ids		string	Elenco di ID utente. Se inviato come stringa, deve essere delimitato da virgole.

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	integer	ID del Gruppo
nome	name	string	Nome del gruppo
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
admin_ids	admin_ids	string	Elenco delimitato da virgole di ID utente che sono amministratori del gruppo (separati da virgole)
note	notes	string	Note su questo gruppo
user_ids	user_ids	string	Elenco delimitato da virgole di ID utente che appartengono a questo gruppo (separati da virgole)
usernames	usernames	string	Elenco delimitato da virgole di nomi utente che appartengono a questo gruppo (separati da virgole)
ftp_permission	ftp_permission	boolean	Se true, gli utenti di questo gruppo possono usare FTP per accedere. Verrà eseguito l'override di un valore false a livello di `ftp_permission` utente.
sftp_permission	sftp_permission	boolean	Se true, gli utenti di questo gruppo possono usare SFTP per accedere. Verrà eseguito l'override di un valore false a livello di `sftp_permission` utente.
dav_permission	dav_permission	boolean	Se true, gli utenti di questo gruppo possono usare WebDAV per accedere. Verrà eseguito l'override di un valore false a livello di `dav_permission` utente.
restapi_permission	restapi_permission	boolean	Se true, gli utenti di questo gruppo possono usare l'API REST per accedere. Verrà eseguito l'override di un valore false a livello di `restapi_permission` utente.
site_id	site_id	integer	ID sede

Aggiornare un utente

ID operazione:: PatchUser

Aggiornare un utente

Parametri

Nome	Chiave	Tipo	Descrizione
Metodo di autenticazione	authentication_method	string	Come viene autenticato l'utente?
Azienda	company	string	Società dell'utente
Email	email	string	Posta elettronica dell'utente.
ID gruppo	group_ids	string	Elenco di ID di gruppo a cui associare l'utente. Delimitato da virgole.
Nome	name	string	Nome completo dell'utente
Note	notes	string	Eventuali note interne sull'utente
Parola chiave	password	string	Password utente.
Richiedi modifica password	require_password_change	boolean	È necessaria una modifica della password al successivo accesso utente?
Home page dell'utente	user_home	string	Home cartella per FTP/SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
Radice utente	user_root	string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
Nome utente	username	string	Nome utente dell'utente

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	integer	ID utente
username	username	string	Nome utente dell'utente
admin_group_ids	admin_group_ids	array of integer	Elenco di ID gruppo di cui l'utente è un amministratore
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
attachments_permission	attachments_permission	boolean	Se `true`, l'utente può creare bundle (noto anche come Condividi collegamenti). Usare invece l'autorizzazione bundle.
api_keys_count	api_keys_count	integer	Numero di chiavi API associate all'utente
authenticate_until	authenticate_until	string	Data o ora pianificate in cui l'utente verrà disattivato
authentication_method	authentication_method	string	Come viene autenticato l'utente?
avatar_url	avatar_url	string	URL che contiene l'avatar dell'utente
fatturabile	billable	boolean	Si tratta di un record utente fatturabile?
billing_permission	billing_permission	boolean	Consentire a questo utente di eseguire operazioni sull'account, sui pagamenti e sulle fatture?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	Consentire a questo utente di ignorare gli elenchi di indirizzi IP a livello di sito?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	Esentare l'utente dalle regole del ciclo di vita dell'utente?
creato_il	created_at	string	Quando l'utente è stato creato
dav_permission	dav_permission	boolean	L'utente può connettersi con WebDAV?
disabled	disabled	boolean	L'utente è disabilitato? Gli utenti disabilitati non possono accedere e non sono conteggiati a scopo di fatturazione. Gli utenti possono essere disabilitati automaticamente dopo un periodo di inattività tramite un'impostazione del sito o la pianificazione per essere disattivati dopo una data specifica.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	Proprietà calcolata che restituisce true se l'utente è disabilitato o scaduto o inattivo.
posta elettronica	email	string	Indirizzo di posta elettronica dell'utente
filesystem_layout	filesystem_layout	string	Layout del file system
first_login_at	first_login_at	string	Prima volta di accesso dell'utente
ftp_permission	ftp_permission	boolean	L'utente può accedere con FTP o FTPS?
group_ids	group_ids	string	Elenco delimitato da virgole di ID gruppo di cui l'utente è membro
header_text	header_text	string	Testo da visualizzare all'utente nell'intestazione dell'interfaccia utente
language	language	string	Lingua preferita
last_login_at	last_login_at	string	Ora di accesso più recente dell'utente tramite qualsiasi protocollo
last_web_login_at	last_web_login_at	string	Ora di accesso più recente dell'utente tramite il Web
last_ftp_login_at	last_ftp_login_at	string	Ora di accesso più recente dell'utente tramite FTP
last_sftp_login_at	last_sftp_login_at	string	Ora di accesso più recente dell'utente tramite SFTP
last_dav_login_at	last_dav_login_at	string	Ora di accesso più recente dell'utente tramite WebDAV
last_desktop_login_at	last_desktop_login_at	string	Ora di accesso più recente dell'utente tramite l'app desktop
last_restapi_login_at	last_restapi_login_at	string	Tempo di accesso più recente dell'utente tramite l'API REST
last_api_use_at	last_api_use_at	string	Tempo di utilizzo dell'API più recente dell'utente
ultima_attività_il	last_active_at	string	Ora più recente dell'attività dell'utente, ovvero l'ultima dell'account di accesso più recente, l'uso più recente dell'API, l'abilitazione o la creazione
last_protocol_cipher	last_protocol_cipher	string	Protocollo e crittografia più recenti usati
lockout_expires	lockout_expires	string	Tempo in futuro in cui l'utente non verrà più bloccato, se applicabile
nome	name	string	Nome completo dell'utente
azienda	company	string	Società dell'utente
note	notes	string	Eventuali note interne sull'utente
notification_daily_send_time	notification_daily_send_time	integer	Ora del giorno in cui devono essere inviate le notifiche giornaliere. Può essere compreso nell'intervallo compreso tra 0 e 23
office_integration_enabled	office_integration_enabled	boolean	Abilitare l'integrazione con Office per il Web?
partner_admin	partner_admin	boolean	L'utente è un amministratore partner?
partner_id	partner_id	integer	ID partner se l'utente appartiene a un partner
partner_name	partner_name	string	Nome del partner se l'utente appartiene a un partner
password_set_at	password_set_at	string	Ora dell'ultima impostazione della password dell'utente
password_validity_days	password_validity_days	integer	Numero di giorni per consentire all'utente di usare la stessa password
public_keys_count	public_keys_count	integer	Numero di chiavi pubbliche associate all'utente
receive_admin_alerts	receive_admin_alerts	boolean	L'utente deve ricevere avvisi di amministratore come le notifiche di scadenza e le eccedenze del certificato?
require_2fa	require_2fa	string	Impostazione richiesta 2FA
require_login_by	require_login_by	string	Richiedere all'utente di eseguire l'accesso in base alla data specificata. In caso contrario, verrà disabilitato.
active_2fa	active_2fa	boolean	2fa è attiva per l'utente?
require_password_change	require_password_change	boolean	È necessaria una modifica della password al successivo accesso utente?
password_expired	password_expired	boolean	La password dell'utente è scaduta?
readonly_site_admin	readonly_site_admin	boolean	L'utente è autorizzato a visualizzare tutta la configurazione del sito (non fatturazione) per questo sito?
restapi_permission	restapi_permission	boolean	Questo utente può accedere all'app Web, all'app desktop, agli SDK o all'API REST? Tutti questi strumenti usano internamente l'API, quindi si tratta di un set di autorizzazioni unificato.
self_managed	self_managed	boolean	L'utente gestisce le proprie credenziali o è un utente condiviso o bot?
sftp_permission	sftp_permission	boolean	L'utente può accedere con SFTP?
site_admin	site_admin	boolean	L'utente è un amministratore per questo sito?
site_id	site_id	integer	ID sede
skip_welcome_screen	skip_welcome_screen	boolean	Ignorare la pagina iniziale nell'interfaccia utente?
ssl_required	ssl_required	string	Impostazione richiesta SSL
sso_strategy_id	sso_strategy_id	integer	ID strategia SSO (Single Sign On) per l'utente, se applicabile.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	L'utente è iscritto alla newsletter?
externally_managed	externally_managed	boolean	L'utente è gestito da SsoStrategy?
tags	tags	string	Elenco delimitato da virgole di tag per l'utente. I tag vengono usati per altre funzionalità, ad esempio UserLifecycleRules, che possono essere destinati a tag specifici. I tag devono contenere solo lettere minuscole, numeri e trattini.
fuso orario	time_zone	string	Fuso orario utente
type_of_2fa	type_of_2fa	string	Tipi di metodi 2FA in uso per l'uso a livello di codice. `sms`Sarà , `totp`, `webauthnyubi`, , `email`o più valori ordinati alfabeticamente e uniti da un carattere di sottolineatura. Non specifica se l'utente dispone di più di un metodo specificato.
type_of_2fa_for_display	type_of_2fa_for_display	string	Tipi di metodi 2FA in uso, formattati per la visualizzazione nell'interfaccia utente. A differenza di `type_of_2fa`, questo valore renderà chiaro quando un utente ha più di 1 dello stesso tipo di metodo.
user_root	user_root	string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
user_home	user_home	string	Home cartella per FTP o SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	Numero di giorni rimanenti fino alla scadenza della password
password_expire_at	password_expire_at	string	Data/ora di scadenza password

Aggiornare un utente

ID operazione:: PatchUsersId

Aggiornare un utente

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID utente.
Metodo di autenticazione	authentication_method		string	Come viene autenticato l'utente?
Azienda	company		string	Società dell'utente
Email	email		string	Posta elettronica dell'utente.
ID gruppo	group_ids		string	Elenco di ID di gruppo a cui associare l'utente. Delimitato da virgole.
Nome	name		string	Nome completo dell'utente
Note	notes		string	Eventuali note interne sull'utente
Parola chiave	password		string	Password utente.
Richiedi modifica password	require_password_change		boolean	È necessaria una modifica della password al successivo accesso utente?
Home page dell'utente	user_home		string	Home cartella per FTP/SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
Radice utente	user_root		string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
Nome utente	username		string	Nome utente dell'utente

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	integer	ID utente
username	username	string	Nome utente dell'utente
admin_group_ids	admin_group_ids	array of integer	Elenco di ID gruppo di cui l'utente è un amministratore
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
attachments_permission	attachments_permission	boolean	Se `true`, l'utente può creare bundle (noto anche come Condividi collegamenti). Usare invece l'autorizzazione bundle.
api_keys_count	api_keys_count	integer	Numero di chiavi API associate all'utente
authenticate_until	authenticate_until	string	Data o ora pianificate in cui l'utente verrà disattivato
authentication_method	authentication_method	string	Come viene autenticato l'utente?
avatar_url	avatar_url	string	URL che contiene l'avatar dell'utente
fatturabile	billable	boolean	Si tratta di un record utente fatturabile?
billing_permission	billing_permission	boolean	Consentire a questo utente di eseguire operazioni sull'account, sui pagamenti e sulle fatture?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	Consentire a questo utente di ignorare gli elenchi di indirizzi IP a livello di sito?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	Esentare l'utente dalle regole del ciclo di vita dell'utente?
creato_il	created_at	string	Quando l'utente è stato creato
dav_permission	dav_permission	boolean	L'utente può connettersi con WebDAV?
disabled	disabled	boolean	L'utente è disabilitato? Gli utenti disabilitati non possono accedere e non sono conteggiati a scopo di fatturazione. Gli utenti possono essere disabilitati automaticamente dopo un periodo di inattività tramite un'impostazione del sito o la pianificazione per essere disattivati dopo una data specifica.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	Proprietà calcolata che restituisce true se l'utente è disabilitato o scaduto o inattivo.
posta elettronica	email	string	Indirizzo di posta elettronica dell'utente
filesystem_layout	filesystem_layout	string	Layout del file system
first_login_at	first_login_at	string	Prima volta di accesso dell'utente
ftp_permission	ftp_permission	boolean	L'utente può accedere con FTP o FTPS?
group_ids	group_ids	string	Elenco delimitato da virgole di ID gruppo di cui l'utente è membro
header_text	header_text	string	Testo da visualizzare all'utente nell'intestazione dell'interfaccia utente
language	language	string	Lingua preferita
last_login_at	last_login_at	string	Ora di accesso più recente dell'utente tramite qualsiasi protocollo
last_web_login_at	last_web_login_at	string	Ora di accesso più recente dell'utente tramite il Web
last_ftp_login_at	last_ftp_login_at	string	Ora di accesso più recente dell'utente tramite FTP
last_sftp_login_at	last_sftp_login_at	string	Ora di accesso più recente dell'utente tramite SFTP
last_dav_login_at	last_dav_login_at	string	Ora di accesso più recente dell'utente tramite WebDAV
last_desktop_login_at	last_desktop_login_at	string	Ora di accesso più recente dell'utente tramite l'app desktop
last_restapi_login_at	last_restapi_login_at	string	Tempo di accesso più recente dell'utente tramite l'API REST
last_api_use_at	last_api_use_at	string	Tempo di utilizzo dell'API più recente dell'utente
ultima_attività_il	last_active_at	string	Ora più recente dell'attività dell'utente, ovvero l'ultima dell'account di accesso più recente, l'uso più recente dell'API, l'abilitazione o la creazione
last_protocol_cipher	last_protocol_cipher	string	Protocollo e crittografia più recenti usati
lockout_expires	lockout_expires	string	Tempo in futuro in cui l'utente non verrà più bloccato, se applicabile
nome	name	string	Nome completo dell'utente
azienda	company	string	Società dell'utente
note	notes	string	Eventuali note interne sull'utente
notification_daily_send_time	notification_daily_send_time	integer	Ora del giorno in cui devono essere inviate le notifiche giornaliere. Può essere compreso nell'intervallo compreso tra 0 e 23
office_integration_enabled	office_integration_enabled	boolean	Abilitare l'integrazione con Office per il Web?
partner_admin	partner_admin	boolean	L'utente è un amministratore partner?
partner_id	partner_id	integer	ID partner se l'utente appartiene a un partner
partner_name	partner_name	string	Nome del partner se l'utente appartiene a un partner
password_set_at	password_set_at	string	Ora dell'ultima impostazione della password dell'utente
password_validity_days	password_validity_days	integer	Numero di giorni per consentire all'utente di usare la stessa password
public_keys_count	public_keys_count	integer	Numero di chiavi pubbliche associate all'utente
receive_admin_alerts	receive_admin_alerts	boolean	L'utente deve ricevere avvisi di amministratore come le notifiche di scadenza e le eccedenze del certificato?
require_2fa	require_2fa	string	Impostazione richiesta 2FA
require_login_by	require_login_by	string	Richiedere all'utente di eseguire l'accesso in base alla data specificata. In caso contrario, verrà disabilitato.
active_2fa	active_2fa	boolean	2fa è attiva per l'utente?
require_password_change	require_password_change	boolean	È necessaria una modifica della password al successivo accesso utente?
password_expired	password_expired	boolean	La password dell'utente è scaduta?
readonly_site_admin	readonly_site_admin	boolean	L'utente è autorizzato a visualizzare tutta la configurazione del sito (non fatturazione) per questo sito?
restapi_permission	restapi_permission	boolean	Questo utente può accedere all'app Web, all'app desktop, agli SDK o all'API REST? Tutti questi strumenti usano internamente l'API, quindi si tratta di un set di autorizzazioni unificato.
self_managed	self_managed	boolean	L'utente gestisce le proprie credenziali o è un utente condiviso o bot?
sftp_permission	sftp_permission	boolean	L'utente può accedere con SFTP?
site_admin	site_admin	boolean	L'utente è un amministratore per questo sito?
site_id	site_id	integer	ID sede
skip_welcome_screen	skip_welcome_screen	boolean	Ignorare la pagina iniziale nell'interfaccia utente?
ssl_required	ssl_required	string	Impostazione richiesta SSL
sso_strategy_id	sso_strategy_id	integer	ID strategia SSO (Single Sign On) per l'utente, se applicabile.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	L'utente è iscritto alla newsletter?
externally_managed	externally_managed	boolean	L'utente è gestito da SsoStrategy?
tags	tags	string	Elenco delimitato da virgole di tag per l'utente. I tag vengono usati per altre funzionalità, ad esempio UserLifecycleRules, che possono essere destinati a tag specifici. I tag devono contenere solo lettere minuscole, numeri e trattini.
fuso orario	time_zone	string	Fuso orario utente
type_of_2fa	type_of_2fa	string	Tipi di metodi 2FA in uso per l'uso a livello di codice. `sms`Sarà , `totp`, `webauthnyubi`, , `email`o più valori ordinati alfabeticamente e uniti da un carattere di sottolineatura. Non specifica se l'utente dispone di più di un metodo specificato.
type_of_2fa_for_display	type_of_2fa_for_display	string	Tipi di metodi 2FA in uso, formattati per la visualizzazione nell'interfaccia utente. A differenza di `type_of_2fa`, questo valore renderà chiaro quando un utente ha più di 1 dello stesso tipo di metodo.
user_root	user_root	string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
user_home	user_home	string	Home cartella per FTP o SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	Numero di giorni rimanenti fino alla scadenza della password
password_expire_at	password_expire_at	string	Data/ora di scadenza password

Carica il file

ID operazione:: UploadFile

Carica il file

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Percorso	path	True	string	Percorso su cui operare.
Contenuto del file	body	True	binary	Contenuto del file da caricare. Inviare i byte esatti da archiviare in Files.com.

Collegamenti di condivisione elenco

ID operazione:: GetBundles

Collegamenti di condivisione elenco

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
codice	code	string	Codice bundle. Questo codice costituisce la parte finale dell'URL pubblico.
color_left	color_left	string	Colore del collegamento e del pulsante della pagina
color_link	color_link	string	Colore del collegamento della barra superiore
color_text	color_text	string	Colore del collegamento e del pulsante della pagina
color_top	color_top	string	Colore di sfondo della barra superiore
color_top_text	color_top_text	string	Colore del testo della barra superiore
URL	url	string	URL pubblico del collegamento di condivisione
descrizione	description	string	Descrizione pubblica
scade_il	expires_at	string	Data o ora di scadenza del bundle
password_protected	password_protected	boolean	Questa password bundle è protetta?
permissions	permissions	string	Autorizzazioni che si applicano alle cartelle in questo collegamento di condivisione.
preview_only	preview_only	boolean
require_registration	require_registration	boolean	Mostra una pagina di registrazione che acquisisce il nome e l'indirizzo di posta elettronica del downloader?
require_share_recipient	require_share_recipient	boolean	Consentire l'accesso solo ai destinatari che hanno ricevuto esplicitamente la condivisione tramite un messaggio di posta elettronica inviato tramite l'interfaccia utente Files.com?
require_logout	require_logout	boolean	Se true, verrà nascosta la casella "Memorizzami" nella pagina Registrazione bundle, richiedendo che l'utente si disconnette e accinga a eseguire nuovamente l'accesso ogni volta che visitano la pagina.
clickwrap_body	clickwrap_body	string	Testo legale che deve essere accettato prima di accedere a Bundle.
id	form_field_set.id	integer	ID set di campi modulo
title	form_field_set.title	string	Titolo da visualizzare
form_layout	form_field_set.form_layout	array of integer	Layout del modulo
form_fields	form_field_set.form_fields	array of object	Campi modulo associati
items	form_field_set.form_fields	object
skip_name	form_field_set.skip_name	boolean	È possibile salvare eventuali InboxRegistrations o BundleRegistrations associati senza specificare il nome
skip_email	form_field_set.skip_email	boolean	Qualsiasi inboxRegistrations o BundleRegistrations associato può essere salvato senza fornire un messaggio di posta elettronica
skip_company	form_field_set.skip_company	boolean	Qualsiasi InboxRegistrations o BundleRegistrations associato può essere salvato senza fornire all'azienda
in_use	form_field_set.in_use	boolean	Il set di campi modulo è in uso da una cartella posta in arrivo o un bundle attivo o registrazione in arrivo o registrazione bundle
skip_name	skip_name	boolean	È possibile salvare bundleRegistrations senza specificare il nome?
skip_email	skip_email	boolean	È possibile salvare bundleRegistrations senza fornire un messaggio di posta elettronica?
start_access_on_date	start_access_on_date	string	Data in cui la condivisione inizierà ad essere accessibile. Se `nil` l'accesso viene concesso subito dopo la creazione.
skip_company	skip_company	boolean	È possibile salvare bundleRegistrations senza fornire un'azienda?
id	id	integer	ID bundle
creato_il	created_at	string	Bundle creato in data o ora
dont_separate_submissions_by_folder	dont_separate_submissions_by_folder	boolean	Non creare sottocartelle per i file caricati in questa condivisione. Nota: ci sono sottili problemi di sicurezza con consentire caricamenti anonimi da più utenti di vivere nella stessa cartella. Sconsigliamo vivamente l'uso di questa opzione a meno che non sia assolutamente necessario.
max_uses	max_uses	integer	Numero massimo di volte in cui è possibile accedere al bundle
nota	note	string	Nota interna bundle
path_template	path_template	string	Modello per la creazione di sottocartelle di invio. Può usare il nome, l'indirizzo di posta elettronica, l'indirizzo di posta elettronica, l'ip, la società, `strftime` le direttive e tutti i dati del modulo personalizzati.
path_template_time_zone	path_template_time_zone	string	Fuso orario da usare per il rendering dei timestamp nei modelli di percorso.
send_email_receipt_to_uploader	send_email_receipt_to_uploader	boolean	Inviare la ricevuta di recapito al caricatore. Nota: solo per la condivisione scrivibile
snapshot_id	snapshot_id	integer	ID dello snapshot contenente il contenuto del bundle.
ID_utente	user_id	integer	ID utente creator bundle
username	username	string	Nome utente creatore bundle
clickwrap_id	clickwrap_id	integer	ID del clickwrap da usare con questo bundle.
inbox_id	inbox_id	integer	ID della posta in arrivo associata, se disponibile.
nome	watermark_attachment.name	string	Nome dell'immagine
URI	watermark_attachment.uri	string	URI dell'immagine
watermark_value	watermark_value	object	Visualizzare in anteprima le impostazioni della filigrana applicate a tutti gli elementi del bundle. Usa le stesse chiavi di Behavior.value
has_inbox	has_inbox	boolean	Questo bundle ha una posta in arrivo associata?
dont_allow_folders_in_uploads	dont_allow_folders_in_uploads	boolean	È consigliabile impedire il caricamento delle cartelle?
Percorsi	paths	array of string	Elenco di percorsi in questo bundle. Per motivi di prestazioni, questo non viene fornito quando si elencano i bundle.
bundlepaths	bundlepaths	array of object	Elenco di bundlepath in questo bundle. Per motivi di prestazioni, questo non viene fornito quando si elencano i bundle.
items	bundlepaths	object

Copia file o cartella

ID operazione:: FileActionCopy

Copia file o cartella

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Percorso	path	True	string	Percorso su cui operare.
Destinazione	destination	True	string	Copiare il percorso di destinazione.

Restituisce

Nome	Percorso	Tipo	Descrizione
status	status	string	Stato dell'operazione file.
file_migration_id	file_migration_id	integer	Se lo stato è in sospeso, si tratta dell'ID della migrazione file per verificare la presenza di aggiornamenti dello stato.

Crea cartella

ID operazione:: PostFoldersPath

Crea cartella

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Percorso	path	True	string	Percorso su cui operare.

Restituisce

Nome	Percorso	Tipo	Descrizione
path	path	string	Percorso file o cartella. Deve essere delimitato da barre, ma non deve iniziare né terminare con una barra. Massimo 5000 caratteri.
created_by_id	created_by_id	integer	ID utente dell'utente che ha creato il file o la cartella
created_by_api_key_id	created_by_api_key_id	integer	ID della chiave API che ha creato il file o la cartella
created_by_as2_incoming_message_id	created_by_as2_incoming_message_id	integer	ID del messaggio in arrivo AS2 che ha creato il file o la cartella
created_by_automation_id	created_by_automation_id	integer	ID dell'automazione che ha creato il file o la cartella
created_by_bundle_registration_id	created_by_bundle_registration_id	integer	ID della registrazione bundle che ha creato il file o la cartella
created_by_inbox_id	created_by_inbox_id	integer	ID della posta in arrivo che ha creato il file o la cartella
created_by_remote_server_id	created_by_remote_server_id	integer	ID del server remoto che ha creato il file o la cartella
created_by_sync_id	created_by_sync_id	integer	ID della sincronizzazione che ha creato il file o la cartella
custom_metadata	custom_metadata	object	Mappa dei metadati personalizzata di chiavi e valori. Limitato a 32 chiavi, 256 caratteri per chiave e 1024 caratteri per valore.
display_name	display_name	string	Nome visualizzato file o cartella
type	type	string	Tipo: `directory` o `file`.
size	size	integer	Dimensioni file o cartelle
creato_il	created_at	string	Data o ora di creazione del file
last_modified_by_id	last_modified_by_id	integer	ID utente dell'utente che ha modificato l'ultima volta il file o la cartella
last_modified_by_api_key_id	last_modified_by_api_key_id	integer	ID della chiave API che ha modificato l'ultima volta il file o la cartella
last_modified_by_automation_id	last_modified_by_automation_id	integer	ID dell'automazione che ha modificato per l'ultima volta il file o la cartella
last_modified_by_bundle_registration_id	last_modified_by_bundle_registration_id	integer	ID della registrazione bundle che ha modificato l'ultima volta il file o la cartella
last_modified_by_remote_server_id	last_modified_by_remote_server_id	integer	ID del server remoto che ha modificato per l'ultima volta il file o la cartella
last_modified_by_sync_id	last_modified_by_sync_id	integer	ID della sincronizzazione che ha modificato l'ultima volta il file o la cartella
Mtime	mtime	string	Data o ora dell'ultima modifica del file, in base al server. Timestamp dell'ultima operazione di Files.com del file, indipendentemente dal timestamp modificato inviato.
provided_mtime	provided_mtime	string	Data o ora dell'ultima modifica del file, in base al client che l'ha impostata. Files.com consente ai client desktop, FTP, SFTP e WebDAV di impostare le modifiche a volte. Ciò consente la sincronizzazione di Desktop-Cloud<> per mantenere le modifiche in alcuni casi.
crc32	crc32	string	Checksum del file CRC32. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
md5	md5	string	Checksum MD5 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
sha1	sha1	string	Checksum SHA1 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
sha256	sha256	string	Checksum SHA256 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
mime_type	mime_type	string	Tipo MIME. Ciò è determinato dall'estensione del nome file e non viene archiviato separatamente internamente.
region	region	string	Località dell'area
permissions	permissions	string	Stringa breve che rappresenta le autorizzazioni dell'utente corrente. Può essere `r` (lettura),`w` (scrittura),`d` (eliminazione), `l` (elenco) o qualsiasi combinazione
subfolders_locked?	subfolders_locked?	boolean	Le sottocartelle sono bloccate e non possono essere modificate?
is_locked	is_locked	boolean	Questa cartella è bloccata e non può essere modificata?
download_uri	download_uri	string	Collegamento per scaricare il file. Fornito solo in risposta a una richiesta di download.
priority_color	priority_color	string	Colore segnalibro o priorità del file o della cartella
preview_id	preview_id	integer	ID anteprima file
id	preview.id	integer	ID anteprima
status	preview.status	string	Stato anteprima. Può essere non valido, not_generated, generazione, completamento o file_too_large
download_uri	preview.download_uri	string	Collegamento per scaricare l'anteprima
type	preview.type	string	Tipo di anteprima. Può essere immagine, pdf, pdf_native, video o audio
size	preview.size	string	Dimensioni anteprima

Crea collegamento di condivisione

ID operazione:: PostBundles

Crea collegamento di condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Description	description		string	Descrizione pubblica
Scade all'ora	expires_at		date-time	Data/ora di scadenza del bundle
Numero massimo di utilizzi	max_uses		integer	Numero massimo di volte in cui è possibile accedere al bundle
Annotazioni	note		string	Nota interna bundle
Parola chiave	password		string	Password per questo bundle.
Paths	paths	True	array of string	Elenco di percorsi da includere in questo bundle.
Richiedi registrazione	require_registration		boolean	Mostra una pagina di registrazione che acquisisce il nome e l'indirizzo di posta elettronica del downloader?

Restituisce

Nome	Percorso	Tipo	Descrizione
codice	code	string	Codice bundle. Questo codice costituisce la parte finale dell'URL pubblico.
color_left	color_left	string	Colore del collegamento e del pulsante della pagina
color_link	color_link	string	Colore del collegamento della barra superiore
color_text	color_text	string	Colore del collegamento e del pulsante della pagina
color_top	color_top	string	Colore di sfondo della barra superiore
color_top_text	color_top_text	string	Colore del testo della barra superiore
URL	url	string	URL pubblico del collegamento di condivisione
descrizione	description	string	Descrizione pubblica
scade_il	expires_at	string	Data o ora di scadenza del bundle
password_protected	password_protected	boolean	Questa password bundle è protetta?
permissions	permissions	string	Autorizzazioni che si applicano alle cartelle in questo collegamento di condivisione.
preview_only	preview_only	boolean
require_registration	require_registration	boolean	Mostra una pagina di registrazione che acquisisce il nome e l'indirizzo di posta elettronica del downloader?
require_share_recipient	require_share_recipient	boolean	Consentire l'accesso solo ai destinatari che hanno ricevuto esplicitamente la condivisione tramite un messaggio di posta elettronica inviato tramite l'interfaccia utente Files.com?
require_logout	require_logout	boolean	Se true, verrà nascosta la casella "Memorizzami" nella pagina Registrazione bundle, richiedendo che l'utente si disconnette e accinga a eseguire nuovamente l'accesso ogni volta che visitano la pagina.
clickwrap_body	clickwrap_body	string	Testo legale che deve essere accettato prima di accedere a Bundle.
id	form_field_set.id	integer	ID set di campi modulo
title	form_field_set.title	string	Titolo da visualizzare
form_layout	form_field_set.form_layout	array of integer	Layout del modulo
form_fields	form_field_set.form_fields	array of object	Campi modulo associati
items	form_field_set.form_fields	object
skip_name	form_field_set.skip_name	boolean	È possibile salvare eventuali InboxRegistrations o BundleRegistrations associati senza specificare il nome
skip_email	form_field_set.skip_email	boolean	Qualsiasi inboxRegistrations o BundleRegistrations associato può essere salvato senza fornire un messaggio di posta elettronica
skip_company	form_field_set.skip_company	boolean	Qualsiasi InboxRegistrations o BundleRegistrations associato può essere salvato senza fornire all'azienda
in_use	form_field_set.in_use	boolean	Il set di campi modulo è in uso da una cartella posta in arrivo o un bundle attivo o registrazione in arrivo o registrazione bundle
skip_name	skip_name	boolean	È possibile salvare bundleRegistrations senza specificare il nome?
skip_email	skip_email	boolean	È possibile salvare bundleRegistrations senza fornire un messaggio di posta elettronica?
start_access_on_date	start_access_on_date	string	Data in cui la condivisione inizierà ad essere accessibile. Se `nil` l'accesso viene concesso subito dopo la creazione.
skip_company	skip_company	boolean	È possibile salvare bundleRegistrations senza fornire un'azienda?
id	id	integer	ID bundle
creato_il	created_at	string	Bundle creato in data o ora
dont_separate_submissions_by_folder	dont_separate_submissions_by_folder	boolean	Non creare sottocartelle per i file caricati in questa condivisione. Nota: ci sono sottili problemi di sicurezza con consentire caricamenti anonimi da più utenti di vivere nella stessa cartella. Sconsigliamo vivamente l'uso di questa opzione a meno che non sia assolutamente necessario.
max_uses	max_uses	integer	Numero massimo di volte in cui è possibile accedere al bundle
nota	note	string	Nota interna bundle
path_template	path_template	string	Modello per la creazione di sottocartelle di invio. Può usare il nome, l'indirizzo di posta elettronica, l'indirizzo di posta elettronica, l'ip, la società, `strftime` le direttive e tutti i dati del modulo personalizzati.
path_template_time_zone	path_template_time_zone	string	Fuso orario da usare per il rendering dei timestamp nei modelli di percorso.
send_email_receipt_to_uploader	send_email_receipt_to_uploader	boolean	Inviare la ricevuta di recapito al caricatore. Nota: solo per la condivisione scrivibile
snapshot_id	snapshot_id	integer	ID dello snapshot contenente il contenuto del bundle.
ID_utente	user_id	integer	ID utente creator bundle
username	username	string	Nome utente creatore bundle
clickwrap_id	clickwrap_id	integer	ID del clickwrap da usare con questo bundle.
inbox_id	inbox_id	integer	ID della posta in arrivo associata, se disponibile.
nome	watermark_attachment.name	string	Nome dell'immagine
URI	watermark_attachment.uri	string	URI dell'immagine
watermark_value	watermark_value	object	Visualizzare in anteprima le impostazioni della filigrana applicate a tutti gli elementi del bundle. Usa le stesse chiavi di Behavior.value
has_inbox	has_inbox	boolean	Questo bundle ha una posta in arrivo associata?
dont_allow_folders_in_uploads	dont_allow_folders_in_uploads	boolean	È consigliabile impedire il caricamento delle cartelle?
Percorsi	paths	array of string	Elenco di percorsi in questo bundle. Per motivi di prestazioni, questo non viene fornito quando si elencano i bundle.
bundlepaths	bundlepaths	array of object	Elenco di bundlepath in questo bundle. Per motivi di prestazioni, questo non viene fornito quando si elencano i bundle.
items	bundlepaths	object

Crea destinatario collegamento condivisione

ID operazione:: PostBundleRecipients

Crea destinatario collegamento condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Bundle Id	bundle_id	True	integer	Aggregazione da condividere.
Azienda	company		string	Società di destinatari.
Nome	name		string	Nome del destinatario.
Annotazioni	note		string	Nota da includere nel messaggio di posta elettronica.
Destinatario	recipient	True	string	Indirizzi di posta elettronica con cui condividere questo bundle.

Restituisce

Nome	Percorso	Tipo	Descrizione
azienda	company	string	Società del destinatario.
nome	name	string	Nome del destinatario.
nota	note	string	Nota inviata al destinatario con il bundle.
destinatario	recipient	string	Indirizzo e-mail del destinatario.
sent_at	sent_at	string	Quando il bundle è stato condiviso con questo destinatario.

Crea gruppo

ID operazione:: PostGroups

Crea gruppo

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID amministratore	admin_ids		string	Elenco di ID utente amministratore del gruppo. Se inviato come stringa, deve essere delimitato da virgole.
Nome	name	True	string	Nome gruppo.
Note	notes		string	Raggruppa le note.
ID utente	user_ids		string	Elenco di ID utente. Se inviato come stringa, deve essere delimitato da virgole.

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	integer	ID del Gruppo
nome	name	string	Nome del gruppo
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
admin_ids	admin_ids	string	Elenco delimitato da virgole di ID utente che sono amministratori del gruppo (separati da virgole)
note	notes	string	Note su questo gruppo
user_ids	user_ids	string	Elenco delimitato da virgole di ID utente che appartengono a questo gruppo (separati da virgole)
usernames	usernames	string	Elenco delimitato da virgole di nomi utente che appartengono a questo gruppo (separati da virgole)
ftp_permission	ftp_permission	boolean	Se true, gli utenti di questo gruppo possono usare FTP per accedere. Verrà eseguito l'override di un valore false a livello di `ftp_permission` utente.
sftp_permission	sftp_permission	boolean	Se true, gli utenti di questo gruppo possono usare SFTP per accedere. Verrà eseguito l'override di un valore false a livello di `sftp_permission` utente.
dav_permission	dav_permission	boolean	Se true, gli utenti di questo gruppo possono usare WebDAV per accedere. Verrà eseguito l'override di un valore false a livello di `dav_permission` utente.
restapi_permission	restapi_permission	boolean	Se true, gli utenti di questo gruppo possono usare l'API REST per accedere. Verrà eseguito l'override di un valore false a livello di `restapi_permission` utente.
site_id	site_id	integer	ID sede

Creare un nuovo account utente per il gruppo

ID operazione:: PostGroupsGroupIdUsers

Creare un nuovo account utente per il gruppo

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
ID gruppo	group_id	True	integer	ID gruppo a cui associare l'utente.
Metodo di autenticazione	authentication_method		string	Come viene autenticato l'utente?
Azienda	company		string	Società dell'utente
Email	email		string	Posta elettronica dell'utente.
ID gruppo	group_ids		string	Elenco di ID di gruppo a cui associare l'utente. Delimitato da virgole.
Nome	name		string	Nome completo dell'utente
Note	notes		string	Eventuali note interne sull'utente
Parola chiave	password		string	Password utente.
Richiedi modifica password	require_password_change		boolean	È necessaria una modifica della password al successivo accesso utente?
Home page dell'utente	user_home		string	Home cartella per FTP/SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
Radice utente	user_root		string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
Nome utente	username	True	string	Nome utente dell'utente

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	integer	ID utente
username	username	string	Nome utente dell'utente
admin_group_ids	admin_group_ids	array of integer	Elenco di ID gruppo di cui l'utente è un amministratore
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
attachments_permission	attachments_permission	boolean	Se `true`, l'utente può creare bundle (noto anche come Condividi collegamenti). Usare invece l'autorizzazione bundle.
api_keys_count	api_keys_count	integer	Numero di chiavi API associate all'utente
authenticate_until	authenticate_until	string	Data o ora pianificate in cui l'utente verrà disattivato
authentication_method	authentication_method	string	Come viene autenticato l'utente?
avatar_url	avatar_url	string	URL che contiene l'avatar dell'utente
fatturabile	billable	boolean	Si tratta di un record utente fatturabile?
billing_permission	billing_permission	boolean	Consentire a questo utente di eseguire operazioni sull'account, sui pagamenti e sulle fatture?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	Consentire a questo utente di ignorare gli elenchi di indirizzi IP a livello di sito?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	Esentare l'utente dalle regole del ciclo di vita dell'utente?
creato_il	created_at	string	Quando l'utente è stato creato
dav_permission	dav_permission	boolean	L'utente può connettersi con WebDAV?
disabled	disabled	boolean	L'utente è disabilitato? Gli utenti disabilitati non possono accedere e non sono conteggiati a scopo di fatturazione. Gli utenti possono essere disabilitati automaticamente dopo un periodo di inattività tramite un'impostazione del sito o la pianificazione per essere disattivati dopo una data specifica.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	Proprietà calcolata che restituisce true se l'utente è disabilitato o scaduto o inattivo.
posta elettronica	email	string	Indirizzo di posta elettronica dell'utente
filesystem_layout	filesystem_layout	string	Layout del file system
first_login_at	first_login_at	string	Prima volta di accesso dell'utente
ftp_permission	ftp_permission	boolean	L'utente può accedere con FTP o FTPS?
group_ids	group_ids	string	Elenco delimitato da virgole di ID gruppo di cui l'utente è membro
header_text	header_text	string	Testo da visualizzare all'utente nell'intestazione dell'interfaccia utente
language	language	string	Lingua preferita
last_login_at	last_login_at	string	Ora di accesso più recente dell'utente tramite qualsiasi protocollo
last_web_login_at	last_web_login_at	string	Ora di accesso più recente dell'utente tramite il Web
last_ftp_login_at	last_ftp_login_at	string	Ora di accesso più recente dell'utente tramite FTP
last_sftp_login_at	last_sftp_login_at	string	Ora di accesso più recente dell'utente tramite SFTP
last_dav_login_at	last_dav_login_at	string	Ora di accesso più recente dell'utente tramite WebDAV
last_desktop_login_at	last_desktop_login_at	string	Ora di accesso più recente dell'utente tramite l'app desktop
last_restapi_login_at	last_restapi_login_at	string	Tempo di accesso più recente dell'utente tramite l'API REST
last_api_use_at	last_api_use_at	string	Tempo di utilizzo dell'API più recente dell'utente
ultima_attività_il	last_active_at	string	Ora più recente dell'attività dell'utente, ovvero l'ultima dell'account di accesso più recente, l'uso più recente dell'API, l'abilitazione o la creazione
last_protocol_cipher	last_protocol_cipher	string	Protocollo e crittografia più recenti usati
lockout_expires	lockout_expires	string	Tempo in futuro in cui l'utente non verrà più bloccato, se applicabile
nome	name	string	Nome completo dell'utente
azienda	company	string	Società dell'utente
note	notes	string	Eventuali note interne sull'utente
notification_daily_send_time	notification_daily_send_time	integer	Ora del giorno in cui devono essere inviate le notifiche giornaliere. Può essere compreso nell'intervallo compreso tra 0 e 23
office_integration_enabled	office_integration_enabled	boolean	Abilitare l'integrazione con Office per il Web?
partner_admin	partner_admin	boolean	L'utente è un amministratore partner?
partner_id	partner_id	integer	ID partner se l'utente appartiene a un partner
partner_name	partner_name	string	Nome del partner se l'utente appartiene a un partner
password_set_at	password_set_at	string	Ora dell'ultima impostazione della password dell'utente
password_validity_days	password_validity_days	integer	Numero di giorni per consentire all'utente di usare la stessa password
public_keys_count	public_keys_count	integer	Numero di chiavi pubbliche associate all'utente
receive_admin_alerts	receive_admin_alerts	boolean	L'utente deve ricevere avvisi di amministratore come le notifiche di scadenza e le eccedenze del certificato?
require_2fa	require_2fa	string	Impostazione richiesta 2FA
require_login_by	require_login_by	string	Richiedere all'utente di eseguire l'accesso in base alla data specificata. In caso contrario, verrà disabilitato.
active_2fa	active_2fa	boolean	2fa è attiva per l'utente?
require_password_change	require_password_change	boolean	È necessaria una modifica della password al successivo accesso utente?
password_expired	password_expired	boolean	La password dell'utente è scaduta?
readonly_site_admin	readonly_site_admin	boolean	L'utente è autorizzato a visualizzare tutta la configurazione del sito (non fatturazione) per questo sito?
restapi_permission	restapi_permission	boolean	Questo utente può accedere all'app Web, all'app desktop, agli SDK o all'API REST? Tutti questi strumenti usano internamente l'API, quindi si tratta di un set di autorizzazioni unificato.
self_managed	self_managed	boolean	L'utente gestisce le proprie credenziali o è un utente condiviso o bot?
sftp_permission	sftp_permission	boolean	L'utente può accedere con SFTP?
site_admin	site_admin	boolean	L'utente è un amministratore per questo sito?
site_id	site_id	integer	ID sede
skip_welcome_screen	skip_welcome_screen	boolean	Ignorare la pagina iniziale nell'interfaccia utente?
ssl_required	ssl_required	string	Impostazione richiesta SSL
sso_strategy_id	sso_strategy_id	integer	ID strategia SSO (Single Sign On) per l'utente, se applicabile.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	L'utente è iscritto alla newsletter?
externally_managed	externally_managed	boolean	L'utente è gestito da SsoStrategy?
tags	tags	string	Elenco delimitato da virgole di tag per l'utente. I tag vengono usati per altre funzionalità, ad esempio UserLifecycleRules, che possono essere destinati a tag specifici. I tag devono contenere solo lettere minuscole, numeri e trattini.
fuso orario	time_zone	string	Fuso orario utente
type_of_2fa	type_of_2fa	string	Tipi di metodi 2FA in uso per l'uso a livello di codice. `sms`Sarà , `totp`, `webauthnyubi`, , `email`o più valori ordinati alfabeticamente e uniti da un carattere di sottolineatura. Non specifica se l'utente dispone di più di un metodo specificato.
type_of_2fa_for_display	type_of_2fa_for_display	string	Tipi di metodi 2FA in uso, formattati per la visualizzazione nell'interfaccia utente. A differenza di `type_of_2fa`, questo valore renderà chiaro quando un utente ha più di 1 dello stesso tipo di metodo.
user_root	user_root	string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
user_home	user_home	string	Home cartella per FTP o SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	Numero di giorni rimanenti fino alla scadenza della password
password_expire_at	password_expire_at	string	Data/ora di scadenza password

Creare un utente

ID operazione:: PostUsers

Creare un utente

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Metodo di autenticazione	authentication_method		string	Come viene autenticato l'utente?
Azienda	company		string	Società dell'utente
Email	email		string	Posta elettronica dell'utente.
ID gruppo	group_ids		string	Elenco di ID di gruppo a cui associare l'utente. Delimitato da virgole.
Nome	name		string	Nome completo dell'utente
Note	notes		string	Eventuali note interne sull'utente
Parola chiave	password		string	Password utente.
Richiedi modifica password	require_password_change		boolean	È necessaria una modifica della password al successivo accesso utente?
Home page dell'utente	user_home		string	Home cartella per FTP/SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
Radice utente	user_root		string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
Nome utente	username	True	string	Nome utente dell'utente

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	integer	ID utente
username	username	string	Nome utente dell'utente
admin_group_ids	admin_group_ids	array of integer	Elenco di ID gruppo di cui l'utente è un amministratore
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
attachments_permission	attachments_permission	boolean	Se `true`, l'utente può creare bundle (noto anche come Condividi collegamenti). Usare invece l'autorizzazione bundle.
api_keys_count	api_keys_count	integer	Numero di chiavi API associate all'utente
authenticate_until	authenticate_until	string	Data o ora pianificate in cui l'utente verrà disattivato
authentication_method	authentication_method	string	Come viene autenticato l'utente?
avatar_url	avatar_url	string	URL che contiene l'avatar dell'utente
fatturabile	billable	boolean	Si tratta di un record utente fatturabile?
billing_permission	billing_permission	boolean	Consentire a questo utente di eseguire operazioni sull'account, sui pagamenti e sulle fatture?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	Consentire a questo utente di ignorare gli elenchi di indirizzi IP a livello di sito?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	Esentare l'utente dalle regole del ciclo di vita dell'utente?
creato_il	created_at	string	Quando l'utente è stato creato
dav_permission	dav_permission	boolean	L'utente può connettersi con WebDAV?
disabled	disabled	boolean	L'utente è disabilitato? Gli utenti disabilitati non possono accedere e non sono conteggiati a scopo di fatturazione. Gli utenti possono essere disabilitati automaticamente dopo un periodo di inattività tramite un'impostazione del sito o la pianificazione per essere disattivati dopo una data specifica.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	Proprietà calcolata che restituisce true se l'utente è disabilitato o scaduto o inattivo.
posta elettronica	email	string	Indirizzo di posta elettronica dell'utente
filesystem_layout	filesystem_layout	string	Layout del file system
first_login_at	first_login_at	string	Prima volta di accesso dell'utente
ftp_permission	ftp_permission	boolean	L'utente può accedere con FTP o FTPS?
group_ids	group_ids	string	Elenco delimitato da virgole di ID gruppo di cui l'utente è membro
header_text	header_text	string	Testo da visualizzare all'utente nell'intestazione dell'interfaccia utente
language	language	string	Lingua preferita
last_login_at	last_login_at	string	Ora di accesso più recente dell'utente tramite qualsiasi protocollo
last_web_login_at	last_web_login_at	string	Ora di accesso più recente dell'utente tramite il Web
last_ftp_login_at	last_ftp_login_at	string	Ora di accesso più recente dell'utente tramite FTP
last_sftp_login_at	last_sftp_login_at	string	Ora di accesso più recente dell'utente tramite SFTP
last_dav_login_at	last_dav_login_at	string	Ora di accesso più recente dell'utente tramite WebDAV
last_desktop_login_at	last_desktop_login_at	string	Ora di accesso più recente dell'utente tramite l'app desktop
last_restapi_login_at	last_restapi_login_at	string	Tempo di accesso più recente dell'utente tramite l'API REST
last_api_use_at	last_api_use_at	string	Tempo di utilizzo dell'API più recente dell'utente
ultima_attività_il	last_active_at	string	Ora più recente dell'attività dell'utente, ovvero l'ultima dell'account di accesso più recente, l'uso più recente dell'API, l'abilitazione o la creazione
last_protocol_cipher	last_protocol_cipher	string	Protocollo e crittografia più recenti usati
lockout_expires	lockout_expires	string	Tempo in futuro in cui l'utente non verrà più bloccato, se applicabile
nome	name	string	Nome completo dell'utente
azienda	company	string	Società dell'utente
note	notes	string	Eventuali note interne sull'utente
notification_daily_send_time	notification_daily_send_time	integer	Ora del giorno in cui devono essere inviate le notifiche giornaliere. Può essere compreso nell'intervallo compreso tra 0 e 23
office_integration_enabled	office_integration_enabled	boolean	Abilitare l'integrazione con Office per il Web?
partner_admin	partner_admin	boolean	L'utente è un amministratore partner?
partner_id	partner_id	integer	ID partner se l'utente appartiene a un partner
partner_name	partner_name	string	Nome del partner se l'utente appartiene a un partner
password_set_at	password_set_at	string	Ora dell'ultima impostazione della password dell'utente
password_validity_days	password_validity_days	integer	Numero di giorni per consentire all'utente di usare la stessa password
public_keys_count	public_keys_count	integer	Numero di chiavi pubbliche associate all'utente
receive_admin_alerts	receive_admin_alerts	boolean	L'utente deve ricevere avvisi di amministratore come le notifiche di scadenza e le eccedenze del certificato?
require_2fa	require_2fa	string	Impostazione richiesta 2FA
require_login_by	require_login_by	string	Richiedere all'utente di eseguire l'accesso in base alla data specificata. In caso contrario, verrà disabilitato.
active_2fa	active_2fa	boolean	2fa è attiva per l'utente?
require_password_change	require_password_change	boolean	È necessaria una modifica della password al successivo accesso utente?
password_expired	password_expired	boolean	La password dell'utente è scaduta?
readonly_site_admin	readonly_site_admin	boolean	L'utente è autorizzato a visualizzare tutta la configurazione del sito (non fatturazione) per questo sito?
restapi_permission	restapi_permission	boolean	Questo utente può accedere all'app Web, all'app desktop, agli SDK o all'API REST? Tutti questi strumenti usano internamente l'API, quindi si tratta di un set di autorizzazioni unificato.
self_managed	self_managed	boolean	L'utente gestisce le proprie credenziali o è un utente condiviso o bot?
sftp_permission	sftp_permission	boolean	L'utente può accedere con SFTP?
site_admin	site_admin	boolean	L'utente è un amministratore per questo sito?
site_id	site_id	integer	ID sede
skip_welcome_screen	skip_welcome_screen	boolean	Ignorare la pagina iniziale nell'interfaccia utente?
ssl_required	ssl_required	string	Impostazione richiesta SSL
sso_strategy_id	sso_strategy_id	integer	ID strategia SSO (Single Sign On) per l'utente, se applicabile.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	L'utente è iscritto alla newsletter?
externally_managed	externally_managed	boolean	L'utente è gestito da SsoStrategy?
tags	tags	string	Elenco delimitato da virgole di tag per l'utente. I tag vengono usati per altre funzionalità, ad esempio UserLifecycleRules, che possono essere destinati a tag specifici. I tag devono contenere solo lettere minuscole, numeri e trattini.
fuso orario	time_zone	string	Fuso orario utente
type_of_2fa	type_of_2fa	string	Tipi di metodi 2FA in uso per l'uso a livello di codice. `sms`Sarà , `totp`, `webauthnyubi`, , `email`o più valori ordinati alfabeticamente e uniti da un carattere di sottolineatura. Non specifica se l'utente dispone di più di un metodo specificato.
type_of_2fa_for_display	type_of_2fa_for_display	string	Tipi di metodi 2FA in uso, formattati per la visualizzazione nell'interfaccia utente. A differenza di `type_of_2fa`, questo valore renderà chiaro quando un utente ha più di 1 dello stesso tipo di metodo.
user_root	user_root	string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
user_home	user_home	string	Home cartella per FTP o SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	Numero di giorni rimanenti fino alla scadenza della password
password_expire_at	password_expire_at	string	Data/ora di scadenza password

Creare una notifica di collegamento di condivisione

ID operazione:: PostBundleNotifications

Creare una notifica di collegamento di condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Bundle Id	bundle_id	True	integer	ID bundle per la notifica
Notifica ID utente	notify_user_id		integer	ID dell'utente da notificare.

Restituisce

Nome	Percorso	Tipo	Descrizione
bundle_id	bundle_id	integer	ID bundle per la notifica
id	id	integer	ID notifica bundle
notify_on_registration	notify_on_registration	boolean	Attiva la notifica del bundle quando si verifica un'azione di registrazione.
notify_on_upload	notify_on_upload	boolean	Attiva la notifica bundle quando si verifica un'azione di caricamento.
notify_user_id	notify_user_id	integer	ID dell'utente da notificare.

Destinatari dei collegamenti di condivisione elenco

ID operazione:: GetBundleRecipients

Destinatari dei collegamenti di condivisione elenco

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Bundle Id	bundle_id	True	integer	Elencare i destinatari per il bundle con questo ID.

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
azienda	company	string	Società del destinatario.
nome	name	string	Nome del destinatario.
nota	note	string	Nota inviata al destinatario con il bundle.
destinatario	recipient	string	Indirizzo e-mail del destinatario.
sent_at	sent_at	string	Quando il bundle è stato condiviso con questo destinatario.

Elenca gruppi

ID operazione:: GetGroups

Elenca gruppi

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
id	id	integer	ID del Gruppo
nome	name	string	Nome del gruppo
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
admin_ids	admin_ids	string	Elenco delimitato da virgole di ID utente che sono amministratori del gruppo (separati da virgole)
note	notes	string	Note su questo gruppo
user_ids	user_ids	string	Elenco delimitato da virgole di ID utente che appartengono a questo gruppo (separati da virgole)
usernames	usernames	string	Elenco delimitato da virgole di nomi utente che appartengono a questo gruppo (separati da virgole)
ftp_permission	ftp_permission	boolean	Se true, gli utenti di questo gruppo possono usare FTP per accedere. Verrà eseguito l'override di un valore false a livello di `ftp_permission` utente.
sftp_permission	sftp_permission	boolean	Se true, gli utenti di questo gruppo possono usare SFTP per accedere. Verrà eseguito l'override di un valore false a livello di `sftp_permission` utente.
dav_permission	dav_permission	boolean	Se true, gli utenti di questo gruppo possono usare WebDAV per accedere. Verrà eseguito l'override di un valore false a livello di `dav_permission` utente.
restapi_permission	restapi_permission	boolean	Se true, gli utenti di questo gruppo possono usare l'API REST per accedere. Verrà eseguito l'override di un valore false a livello di `restapi_permission` utente.
site_id	site_id	integer	ID sede

Elenca utenti

ID operazione:: GetUsers

Elenca utenti

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
id	id	integer	ID utente
username	username	string	Nome utente dell'utente
admin_group_ids	admin_group_ids	array of integer	Elenco di ID gruppo di cui l'utente è un amministratore
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
attachments_permission	attachments_permission	boolean	Se `true`, l'utente può creare bundle (noto anche come Condividi collegamenti). Usare invece l'autorizzazione bundle.
api_keys_count	api_keys_count	integer	Numero di chiavi API associate all'utente
authenticate_until	authenticate_until	string	Data o ora pianificate in cui l'utente verrà disattivato
authentication_method	authentication_method	string	Come viene autenticato l'utente?
avatar_url	avatar_url	string	URL che contiene l'avatar dell'utente
fatturabile	billable	boolean	Si tratta di un record utente fatturabile?
billing_permission	billing_permission	boolean	Consentire a questo utente di eseguire operazioni sull'account, sui pagamenti e sulle fatture?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	Consentire a questo utente di ignorare gli elenchi di indirizzi IP a livello di sito?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	Esentare l'utente dalle regole del ciclo di vita dell'utente?
creato_il	created_at	string	Quando l'utente è stato creato
dav_permission	dav_permission	boolean	L'utente può connettersi con WebDAV?
disabled	disabled	boolean	L'utente è disabilitato? Gli utenti disabilitati non possono accedere e non sono conteggiati a scopo di fatturazione. Gli utenti possono essere disabilitati automaticamente dopo un periodo di inattività tramite un'impostazione del sito o la pianificazione per essere disattivati dopo una data specifica.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	Proprietà calcolata che restituisce true se l'utente è disabilitato o scaduto o inattivo.
posta elettronica	email	string	Indirizzo di posta elettronica dell'utente
filesystem_layout	filesystem_layout	string	Layout del file system
first_login_at	first_login_at	string	Prima volta di accesso dell'utente
ftp_permission	ftp_permission	boolean	L'utente può accedere con FTP o FTPS?
group_ids	group_ids	string	Elenco delimitato da virgole di ID gruppo di cui l'utente è membro
header_text	header_text	string	Testo da visualizzare all'utente nell'intestazione dell'interfaccia utente
language	language	string	Lingua preferita
last_login_at	last_login_at	string	Ora di accesso più recente dell'utente tramite qualsiasi protocollo
last_web_login_at	last_web_login_at	string	Ora di accesso più recente dell'utente tramite il Web
last_ftp_login_at	last_ftp_login_at	string	Ora di accesso più recente dell'utente tramite FTP
last_sftp_login_at	last_sftp_login_at	string	Ora di accesso più recente dell'utente tramite SFTP
last_dav_login_at	last_dav_login_at	string	Ora di accesso più recente dell'utente tramite WebDAV
last_desktop_login_at	last_desktop_login_at	string	Ora di accesso più recente dell'utente tramite l'app desktop
last_restapi_login_at	last_restapi_login_at	string	Tempo di accesso più recente dell'utente tramite l'API REST
last_api_use_at	last_api_use_at	string	Tempo di utilizzo dell'API più recente dell'utente
ultima_attività_il	last_active_at	string	Ora più recente dell'attività dell'utente, ovvero l'ultima dell'account di accesso più recente, l'uso più recente dell'API, l'abilitazione o la creazione
last_protocol_cipher	last_protocol_cipher	string	Protocollo e crittografia più recenti usati
lockout_expires	lockout_expires	string	Tempo in futuro in cui l'utente non verrà più bloccato, se applicabile
nome	name	string	Nome completo dell'utente
azienda	company	string	Società dell'utente
note	notes	string	Eventuali note interne sull'utente
notification_daily_send_time	notification_daily_send_time	integer	Ora del giorno in cui devono essere inviate le notifiche giornaliere. Può essere compreso nell'intervallo compreso tra 0 e 23
office_integration_enabled	office_integration_enabled	boolean	Abilitare l'integrazione con Office per il Web?
partner_admin	partner_admin	boolean	L'utente è un amministratore partner?
partner_id	partner_id	integer	ID partner se l'utente appartiene a un partner
partner_name	partner_name	string	Nome del partner se l'utente appartiene a un partner
password_set_at	password_set_at	string	Ora dell'ultima impostazione della password dell'utente
password_validity_days	password_validity_days	integer	Numero di giorni per consentire all'utente di usare la stessa password
public_keys_count	public_keys_count	integer	Numero di chiavi pubbliche associate all'utente
receive_admin_alerts	receive_admin_alerts	boolean	L'utente deve ricevere avvisi di amministratore come le notifiche di scadenza e le eccedenze del certificato?
require_2fa	require_2fa	string	Impostazione richiesta 2FA
require_login_by	require_login_by	string	Richiedere all'utente di eseguire l'accesso in base alla data specificata. In caso contrario, verrà disabilitato.
active_2fa	active_2fa	boolean	2fa è attiva per l'utente?
require_password_change	require_password_change	boolean	È necessaria una modifica della password al successivo accesso utente?
password_expired	password_expired	boolean	La password dell'utente è scaduta?
readonly_site_admin	readonly_site_admin	boolean	L'utente è autorizzato a visualizzare tutta la configurazione del sito (non fatturazione) per questo sito?
restapi_permission	restapi_permission	boolean	Questo utente può accedere all'app Web, all'app desktop, agli SDK o all'API REST? Tutti questi strumenti usano internamente l'API, quindi si tratta di un set di autorizzazioni unificato.
self_managed	self_managed	boolean	L'utente gestisce le proprie credenziali o è un utente condiviso o bot?
sftp_permission	sftp_permission	boolean	L'utente può accedere con SFTP?
site_admin	site_admin	boolean	L'utente è un amministratore per questo sito?
site_id	site_id	integer	ID sede
skip_welcome_screen	skip_welcome_screen	boolean	Ignorare la pagina iniziale nell'interfaccia utente?
ssl_required	ssl_required	string	Impostazione richiesta SSL
sso_strategy_id	sso_strategy_id	integer	ID strategia SSO (Single Sign On) per l'utente, se applicabile.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	L'utente è iscritto alla newsletter?
externally_managed	externally_managed	boolean	L'utente è gestito da SsoStrategy?
tags	tags	string	Elenco delimitato da virgole di tag per l'utente. I tag vengono usati per altre funzionalità, ad esempio UserLifecycleRules, che possono essere destinati a tag specifici. I tag devono contenere solo lettere minuscole, numeri e trattini.
fuso orario	time_zone	string	Fuso orario utente
type_of_2fa	type_of_2fa	string	Tipi di metodi 2FA in uso per l'uso a livello di codice. `sms`Sarà , `totp`, `webauthnyubi`, , `email`o più valori ordinati alfabeticamente e uniti da un carattere di sottolineatura. Non specifica se l'utente dispone di più di un metodo specificato.
type_of_2fa_for_display	type_of_2fa_for_display	string	Tipi di metodi 2FA in uso, formattati per la visualizzazione nell'interfaccia utente. A differenza di `type_of_2fa`, questo valore renderà chiaro quando un utente ha più di 1 dello stesso tipo di metodo.
user_root	user_root	string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
user_home	user_home	string	Home cartella per FTP o SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	Numero di giorni rimanenti fino alla scadenza della password
password_expire_at	password_expire_at	string	Data/ora di scadenza password

Elencare cartelle per percorso

ID operazione:: FolderListForPath

Elencare cartelle per percorso

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Percorso	path	True	string	Percorso su cui operare.

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
path	path	string	Percorso file o cartella. Deve essere delimitato da barre, ma non deve iniziare né terminare con una barra. Massimo 5000 caratteri.
created_by_id	created_by_id	integer	ID utente dell'utente che ha creato il file o la cartella
created_by_api_key_id	created_by_api_key_id	integer	ID della chiave API che ha creato il file o la cartella
created_by_as2_incoming_message_id	created_by_as2_incoming_message_id	integer	ID del messaggio in arrivo AS2 che ha creato il file o la cartella
created_by_automation_id	created_by_automation_id	integer	ID dell'automazione che ha creato il file o la cartella
created_by_bundle_registration_id	created_by_bundle_registration_id	integer	ID della registrazione bundle che ha creato il file o la cartella
created_by_inbox_id	created_by_inbox_id	integer	ID della posta in arrivo che ha creato il file o la cartella
created_by_remote_server_id	created_by_remote_server_id	integer	ID del server remoto che ha creato il file o la cartella
created_by_sync_id	created_by_sync_id	integer	ID della sincronizzazione che ha creato il file o la cartella
custom_metadata	custom_metadata	object	Mappa dei metadati personalizzata di chiavi e valori. Limitato a 32 chiavi, 256 caratteri per chiave e 1024 caratteri per valore.
display_name	display_name	string	Nome visualizzato file o cartella
type	type	string	Tipo: `directory` o `file`.
size	size	integer	Dimensioni file o cartelle
creato_il	created_at	string	Data o ora di creazione del file
last_modified_by_id	last_modified_by_id	integer	ID utente dell'utente che ha modificato l'ultima volta il file o la cartella
last_modified_by_api_key_id	last_modified_by_api_key_id	integer	ID della chiave API che ha modificato l'ultima volta il file o la cartella
last_modified_by_automation_id	last_modified_by_automation_id	integer	ID dell'automazione che ha modificato per l'ultima volta il file o la cartella
last_modified_by_bundle_registration_id	last_modified_by_bundle_registration_id	integer	ID della registrazione bundle che ha modificato l'ultima volta il file o la cartella
last_modified_by_remote_server_id	last_modified_by_remote_server_id	integer	ID del server remoto che ha modificato per l'ultima volta il file o la cartella
last_modified_by_sync_id	last_modified_by_sync_id	integer	ID della sincronizzazione che ha modificato l'ultima volta il file o la cartella
Mtime	mtime	string	Data o ora dell'ultima modifica del file, in base al server. Timestamp dell'ultima operazione di Files.com del file, indipendentemente dal timestamp modificato inviato.
provided_mtime	provided_mtime	string	Data o ora dell'ultima modifica del file, in base al client che l'ha impostata. Files.com consente ai client desktop, FTP, SFTP e WebDAV di impostare le modifiche a volte. Ciò consente la sincronizzazione di Desktop-Cloud<> per mantenere le modifiche in alcuni casi.
crc32	crc32	string	Checksum del file CRC32. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
md5	md5	string	Checksum MD5 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
sha1	sha1	string	Checksum SHA1 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
sha256	sha256	string	Checksum SHA256 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
mime_type	mime_type	string	Tipo MIME. Ciò è determinato dall'estensione del nome file e non viene archiviato separatamente internamente.
region	region	string	Località dell'area
permissions	permissions	string	Stringa breve che rappresenta le autorizzazioni dell'utente corrente. Può essere `r` (lettura),`w` (scrittura),`d` (eliminazione), `l` (elenco) o qualsiasi combinazione
subfolders_locked?	subfolders_locked?	boolean	Le sottocartelle sono bloccate e non possono essere modificate?
is_locked	is_locked	boolean	Questa cartella è bloccata e non può essere modificata?
download_uri	download_uri	string	Collegamento per scaricare il file. Fornito solo in risposta a una richiesta di download.
priority_color	priority_color	string	Colore segnalibro o priorità del file o della cartella
preview_id	preview_id	integer	ID anteprima file
id	preview.id	integer	ID anteprima
status	preview.status	string	Stato anteprima. Può essere non valido, not_generated, generazione, completamento o file_too_large
download_uri	preview.download_uri	string	Collegamento per scaricare l'anteprima
type	preview.type	string	Tipo di anteprima. Può essere immagine, pdf, pdf_native, video o audio
size	preview.size	string	Dimensioni anteprima

Elencare i download dei collegamenti di condivisione

ID operazione:: GetBundleDownloads

Elencare i download dei collegamenti di condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Bundle Id	bundle_id		integer	ID bundle

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
codice	bundle_registration.code	string	Codice del cookie di registrazione
nome	bundle_registration.name	string	Nome registrante
azienda	bundle_registration.company	string	Nome società registrante
posta elettronica	bundle_registration.email	string	Indirizzo di posta elettronica registrante
ip	bundle_registration.ip	string	Indirizzo IP registrante
inbox_code	bundle_registration.inbox_code	string	Codice del cookie InboxRegistration, se è presente un controllo InboxRegistration associato
clickwrap_body	bundle_registration.clickwrap_body	string	Fare clic sul testo visualizzato nel registrante
form_field_set_id	bundle_registration.form_field_set_id	integer	ID del set di campi modulo associato
form_field_data	bundle_registration.form_field_data	object	Dati per il set di campi modulo con ID campo modulo come chiavi e dati utente come valori
bundle_code	bundle_registration.bundle_code	string	Codice URL bundle
bundle_id	bundle_registration.bundle_id	integer	ID del bundle associato
bundle_recipient_id	bundle_registration.bundle_recipient_id	integer	ID del destinatario del bundle associato
creato_il	bundle_registration.created_at	string	Data o ora di creazione della registrazione
download_method	download_method	string	Metodo download (file o full_zip)
path	path	string	Percorso di download. Deve essere delimitato da barre, ma non deve iniziare né terminare con una barra. Massimo 5000 caratteri.
creato_il	created_at	string	Scarica data o ora

Elencare le notifiche dei collegamenti di condivisione

ID operazione:: GetBundleNotifications

Elencare le notifiche dei collegamenti di condivisione

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
bundle_id	bundle_id	integer	ID bundle per la notifica
id	id	integer	ID notifica bundle
notify_on_registration	notify_on_registration	boolean	Attiva la notifica del bundle quando si verifica un'azione di registrazione.
notify_on_upload	notify_on_upload	boolean	Attiva la notifica bundle quando si verifica un'azione di caricamento.
notify_user_id	notify_user_id	integer	ID dell'utente da notificare.

Elimina collegamento condivisione

ID operazione:: DeleteBundlesId

Elimina collegamento condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID bundle.

Elimina file o cartella

ID operazione:: DeleteFilesPath

Elimina file o cartella

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Percorso	path	True	string	Percorso su cui operare.

Elimina notifica collegamento condivisione

ID operazione:: DeleteBundleNotificationsId

Elimina notifica collegamento condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID notifica bundle.

Eliminare un gruppo

ID operazione:: DeleteGroupsId

Eliminare un gruppo

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID gruppo.

Eliminazione di un utente.

ID operazione:: DeleteUsersId

Eliminazione di un utente.

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID utente.

ID operazione:: GetBundleRegistrations

List Share Link Registrations

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Bundle Id	bundle_id		integer	ID del bundle associato

Restituisce

Nome	Percorso	Tipo	Descrizione
		array of object
codice	code	string	Codice del cookie di registrazione
nome	name	string	Nome registrante
azienda	company	string	Nome società registrante
posta elettronica	email	string	Indirizzo di posta elettronica registrante
ip	ip	string	Indirizzo IP registrante
inbox_code	inbox_code	string	Codice del cookie InboxRegistration, se è presente un controllo InboxRegistration associato
clickwrap_body	clickwrap_body	string	Fare clic sul testo visualizzato nel registrante
form_field_set_id	form_field_set_id	integer	ID del set di campi modulo associato
form_field_data	form_field_data	object	Dati per il set di campi modulo con ID campo modulo come chiavi e dati utente come valori
bundle_code	bundle_code	string	Codice URL bundle
bundle_id	bundle_id	integer	ID del bundle associato
bundle_recipient_id	bundle_recipient_id	integer	ID del destinatario del bundle associato
creato_il	created_at	string	Data o ora di creazione della registrazione

Mostra collegamento di condivisione

ID operazione:: GetBundlesId

Mostra collegamento di condivisione

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID bundle.

Restituisce

Nome	Percorso	Tipo	Descrizione
codice	code	string	Codice bundle. Questo codice costituisce la parte finale dell'URL pubblico.
color_left	color_left	string	Colore del collegamento e del pulsante della pagina
color_link	color_link	string	Colore del collegamento della barra superiore
color_text	color_text	string	Colore del collegamento e del pulsante della pagina
color_top	color_top	string	Colore di sfondo della barra superiore
color_top_text	color_top_text	string	Colore del testo della barra superiore
URL	url	string	URL pubblico del collegamento di condivisione
descrizione	description	string	Descrizione pubblica
scade_il	expires_at	string	Data o ora di scadenza del bundle
password_protected	password_protected	boolean	Questa password bundle è protetta?
permissions	permissions	string	Autorizzazioni che si applicano alle cartelle in questo collegamento di condivisione.
preview_only	preview_only	boolean
require_registration	require_registration	boolean	Mostra una pagina di registrazione che acquisisce il nome e l'indirizzo di posta elettronica del downloader?
require_share_recipient	require_share_recipient	boolean	Consentire l'accesso solo ai destinatari che hanno ricevuto esplicitamente la condivisione tramite un messaggio di posta elettronica inviato tramite l'interfaccia utente Files.com?
require_logout	require_logout	boolean	Se true, verrà nascosta la casella "Memorizzami" nella pagina Registrazione bundle, richiedendo che l'utente si disconnette e accinga a eseguire nuovamente l'accesso ogni volta che visitano la pagina.
clickwrap_body	clickwrap_body	string	Testo legale che deve essere accettato prima di accedere a Bundle.
id	form_field_set.id	integer	ID set di campi modulo
title	form_field_set.title	string	Titolo da visualizzare
form_layout	form_field_set.form_layout	array of integer	Layout del modulo
form_fields	form_field_set.form_fields	array of object	Campi modulo associati
items	form_field_set.form_fields	object
skip_name	form_field_set.skip_name	boolean	È possibile salvare eventuali InboxRegistrations o BundleRegistrations associati senza specificare il nome
skip_email	form_field_set.skip_email	boolean	Qualsiasi inboxRegistrations o BundleRegistrations associato può essere salvato senza fornire un messaggio di posta elettronica
skip_company	form_field_set.skip_company	boolean	Qualsiasi InboxRegistrations o BundleRegistrations associato può essere salvato senza fornire all'azienda
in_use	form_field_set.in_use	boolean	Il set di campi modulo è in uso da una cartella posta in arrivo o un bundle attivo o registrazione in arrivo o registrazione bundle
skip_name	skip_name	boolean	È possibile salvare bundleRegistrations senza specificare il nome?
skip_email	skip_email	boolean	È possibile salvare bundleRegistrations senza fornire un messaggio di posta elettronica?
start_access_on_date	start_access_on_date	string	Data in cui la condivisione inizierà ad essere accessibile. Se `nil` l'accesso viene concesso subito dopo la creazione.
skip_company	skip_company	boolean	È possibile salvare bundleRegistrations senza fornire un'azienda?
id	id	integer	ID bundle
creato_il	created_at	string	Bundle creato in data o ora
dont_separate_submissions_by_folder	dont_separate_submissions_by_folder	boolean	Non creare sottocartelle per i file caricati in questa condivisione. Nota: ci sono sottili problemi di sicurezza con consentire caricamenti anonimi da più utenti di vivere nella stessa cartella. Sconsigliamo vivamente l'uso di questa opzione a meno che non sia assolutamente necessario.
max_uses	max_uses	integer	Numero massimo di volte in cui è possibile accedere al bundle
nota	note	string	Nota interna bundle
path_template	path_template	string	Modello per la creazione di sottocartelle di invio. Può usare il nome, l'indirizzo di posta elettronica, l'indirizzo di posta elettronica, l'ip, la società, `strftime` le direttive e tutti i dati del modulo personalizzati.
path_template_time_zone	path_template_time_zone	string	Fuso orario da usare per il rendering dei timestamp nei modelli di percorso.
send_email_receipt_to_uploader	send_email_receipt_to_uploader	boolean	Inviare la ricevuta di recapito al caricatore. Nota: solo per la condivisione scrivibile
snapshot_id	snapshot_id	integer	ID dello snapshot contenente il contenuto del bundle.
ID_utente	user_id	integer	ID utente creator bundle
username	username	string	Nome utente creatore bundle
clickwrap_id	clickwrap_id	integer	ID del clickwrap da usare con questo bundle.
inbox_id	inbox_id	integer	ID della posta in arrivo associata, se disponibile.
nome	watermark_attachment.name	string	Nome dell'immagine
URI	watermark_attachment.uri	string	URI dell'immagine
watermark_value	watermark_value	object	Visualizzare in anteprima le impostazioni della filigrana applicate a tutti gli elementi del bundle. Usa le stesse chiavi di Behavior.value
has_inbox	has_inbox	boolean	Questo bundle ha una posta in arrivo associata?
dont_allow_folders_in_uploads	dont_allow_folders_in_uploads	boolean	È consigliabile impedire il caricamento delle cartelle?
Percorsi	paths	array of string	Elenco di percorsi in questo bundle. Per motivi di prestazioni, questo non viene fornito quando si elencano i bundle.
bundlepaths	bundlepaths	array of object	Elenco di bundlepath in questo bundle. Per motivi di prestazioni, questo non viene fornito quando si elencano i bundle.
items	bundlepaths	object

Mostra gruppo

ID operazione:: GetGroupsId

Mostra gruppo

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID gruppo.

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	integer	ID del Gruppo
nome	name	string	Nome del gruppo
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
admin_ids	admin_ids	string	Elenco delimitato da virgole di ID utente che sono amministratori del gruppo (separati da virgole)
note	notes	string	Note su questo gruppo
user_ids	user_ids	string	Elenco delimitato da virgole di ID utente che appartengono a questo gruppo (separati da virgole)
usernames	usernames	string	Elenco delimitato da virgole di nomi utente che appartengono a questo gruppo (separati da virgole)
ftp_permission	ftp_permission	boolean	Se true, gli utenti di questo gruppo possono usare FTP per accedere. Verrà eseguito l'override di un valore false a livello di `ftp_permission` utente.
sftp_permission	sftp_permission	boolean	Se true, gli utenti di questo gruppo possono usare SFTP per accedere. Verrà eseguito l'override di un valore false a livello di `sftp_permission` utente.
dav_permission	dav_permission	boolean	Se true, gli utenti di questo gruppo possono usare WebDAV per accedere. Verrà eseguito l'override di un valore false a livello di `dav_permission` utente.
restapi_permission	restapi_permission	boolean	Se true, gli utenti di questo gruppo possono usare l'API REST per accedere. Verrà eseguito l'override di un valore false a livello di `restapi_permission` utente.
site_id	site_id	integer	ID sede

Mostra notifica di condivisione collegamento

ID operazione:: GetBundleNotificationsId

Mostra notifica di condivisione collegamento

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID notifica bundle.

Restituisce

Nome	Percorso	Tipo	Descrizione
bundle_id	bundle_id	integer	ID bundle per la notifica
id	id	integer	ID notifica bundle
notify_on_registration	notify_on_registration	boolean	Attiva la notifica del bundle quando si verifica un'azione di registrazione.
notify_on_upload	notify_on_upload	boolean	Attiva la notifica bundle quando si verifica un'azione di caricamento.
notify_user_id	notify_user_id	integer	ID dell'utente da notificare.

Mostra utente

ID operazione:: GetUsersId

Mostra utente

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
id	id	True	integer	ID utente.

Restituisce

Nome	Percorso	Tipo	Descrizione
id	id	integer	ID utente
username	username	string	Nome utente dell'utente
admin_group_ids	admin_group_ids	array of integer	Elenco di ID gruppo di cui l'utente è un amministratore
allowed_ips	allowed_ips	string	Elenco di indirizzi IP consentiti, se applicabile. Nuova riga delimitata
attachments_permission	attachments_permission	boolean	Se `true`, l'utente può creare bundle (noto anche come Condividi collegamenti). Usare invece l'autorizzazione bundle.
api_keys_count	api_keys_count	integer	Numero di chiavi API associate all'utente
authenticate_until	authenticate_until	string	Data o ora pianificate in cui l'utente verrà disattivato
authentication_method	authentication_method	string	Come viene autenticato l'utente?
avatar_url	avatar_url	string	URL che contiene l'avatar dell'utente
fatturabile	billable	boolean	Si tratta di un record utente fatturabile?
billing_permission	billing_permission	boolean	Consentire a questo utente di eseguire operazioni sull'account, sui pagamenti e sulle fatture?
bypass_site_allowed_ips	bypass_site_allowed_ips	boolean	Consentire a questo utente di ignorare gli elenchi di indirizzi IP a livello di sito?
bypass_user_lifecycle_rules	bypass_user_lifecycle_rules	boolean	Esentare l'utente dalle regole del ciclo di vita dell'utente?
creato_il	created_at	string	Quando l'utente è stato creato
dav_permission	dav_permission	boolean	L'utente può connettersi con WebDAV?
disabled	disabled	boolean	L'utente è disabilitato? Gli utenti disabilitati non possono accedere e non sono conteggiati a scopo di fatturazione. Gli utenti possono essere disabilitati automaticamente dopo un periodo di inattività tramite un'impostazione del sito o la pianificazione per essere disattivati dopo una data specifica.
disabled_expired_or_inactive	disabled_expired_or_inactive	boolean	Proprietà calcolata che restituisce true se l'utente è disabilitato o scaduto o inattivo.
posta elettronica	email	string	Indirizzo di posta elettronica dell'utente
filesystem_layout	filesystem_layout	string	Layout del file system
first_login_at	first_login_at	string	Prima volta di accesso dell'utente
ftp_permission	ftp_permission	boolean	L'utente può accedere con FTP o FTPS?
group_ids	group_ids	string	Elenco delimitato da virgole di ID gruppo di cui l'utente è membro
header_text	header_text	string	Testo da visualizzare all'utente nell'intestazione dell'interfaccia utente
language	language	string	Lingua preferita
last_login_at	last_login_at	string	Ora di accesso più recente dell'utente tramite qualsiasi protocollo
last_web_login_at	last_web_login_at	string	Ora di accesso più recente dell'utente tramite il Web
last_ftp_login_at	last_ftp_login_at	string	Ora di accesso più recente dell'utente tramite FTP
last_sftp_login_at	last_sftp_login_at	string	Ora di accesso più recente dell'utente tramite SFTP
last_dav_login_at	last_dav_login_at	string	Ora di accesso più recente dell'utente tramite WebDAV
last_desktop_login_at	last_desktop_login_at	string	Ora di accesso più recente dell'utente tramite l'app desktop
last_restapi_login_at	last_restapi_login_at	string	Tempo di accesso più recente dell'utente tramite l'API REST
last_api_use_at	last_api_use_at	string	Tempo di utilizzo dell'API più recente dell'utente
ultima_attività_il	last_active_at	string	Ora più recente dell'attività dell'utente, ovvero l'ultima dell'account di accesso più recente, l'uso più recente dell'API, l'abilitazione o la creazione
last_protocol_cipher	last_protocol_cipher	string	Protocollo e crittografia più recenti usati
lockout_expires	lockout_expires	string	Tempo in futuro in cui l'utente non verrà più bloccato, se applicabile
nome	name	string	Nome completo dell'utente
azienda	company	string	Società dell'utente
note	notes	string	Eventuali note interne sull'utente
notification_daily_send_time	notification_daily_send_time	integer	Ora del giorno in cui devono essere inviate le notifiche giornaliere. Può essere compreso nell'intervallo compreso tra 0 e 23
office_integration_enabled	office_integration_enabled	boolean	Abilitare l'integrazione con Office per il Web?
partner_admin	partner_admin	boolean	L'utente è un amministratore partner?
partner_id	partner_id	integer	ID partner se l'utente appartiene a un partner
partner_name	partner_name	string	Nome del partner se l'utente appartiene a un partner
password_set_at	password_set_at	string	Ora dell'ultima impostazione della password dell'utente
password_validity_days	password_validity_days	integer	Numero di giorni per consentire all'utente di usare la stessa password
public_keys_count	public_keys_count	integer	Numero di chiavi pubbliche associate all'utente
receive_admin_alerts	receive_admin_alerts	boolean	L'utente deve ricevere avvisi di amministratore come le notifiche di scadenza e le eccedenze del certificato?
require_2fa	require_2fa	string	Impostazione richiesta 2FA
require_login_by	require_login_by	string	Richiedere all'utente di eseguire l'accesso in base alla data specificata. In caso contrario, verrà disabilitato.
active_2fa	active_2fa	boolean	2fa è attiva per l'utente?
require_password_change	require_password_change	boolean	È necessaria una modifica della password al successivo accesso utente?
password_expired	password_expired	boolean	La password dell'utente è scaduta?
readonly_site_admin	readonly_site_admin	boolean	L'utente è autorizzato a visualizzare tutta la configurazione del sito (non fatturazione) per questo sito?
restapi_permission	restapi_permission	boolean	Questo utente può accedere all'app Web, all'app desktop, agli SDK o all'API REST? Tutti questi strumenti usano internamente l'API, quindi si tratta di un set di autorizzazioni unificato.
self_managed	self_managed	boolean	L'utente gestisce le proprie credenziali o è un utente condiviso o bot?
sftp_permission	sftp_permission	boolean	L'utente può accedere con SFTP?
site_admin	site_admin	boolean	L'utente è un amministratore per questo sito?
site_id	site_id	integer	ID sede
skip_welcome_screen	skip_welcome_screen	boolean	Ignorare la pagina iniziale nell'interfaccia utente?
ssl_required	ssl_required	string	Impostazione richiesta SSL
sso_strategy_id	sso_strategy_id	integer	ID strategia SSO (Single Sign On) per l'utente, se applicabile.
subscribe_to_newsletter	subscribe_to_newsletter	boolean	L'utente è iscritto alla newsletter?
externally_managed	externally_managed	boolean	L'utente è gestito da SsoStrategy?
tags	tags	string	Elenco delimitato da virgole di tag per l'utente. I tag vengono usati per altre funzionalità, ad esempio UserLifecycleRules, che possono essere destinati a tag specifici. I tag devono contenere solo lettere minuscole, numeri e trattini.
fuso orario	time_zone	string	Fuso orario utente
type_of_2fa	type_of_2fa	string	Tipi di metodi 2FA in uso per l'uso a livello di codice. `sms`Sarà , `totp`, `webauthnyubi`, , `email`o più valori ordinati alfabeticamente e uniti da un carattere di sottolineatura. Non specifica se l'utente dispone di più di un metodo specificato.
type_of_2fa_for_display	type_of_2fa_for_display	string	Tipi di metodi 2FA in uso, formattati per la visualizzazione nell'interfaccia utente. A differenza di `type_of_2fa`, questo valore renderà chiaro quando un utente ha più di 1 dello stesso tipo di metodo.
user_root	user_root	string	Cartella radice per FTP (e facoltativamente SFTP se è impostata l'impostazione appropriata a livello di sito). Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
user_home	user_home	string	Home cartella per FTP o SFTP. Si noti che non viene usato per l'API, desktop o l'interfaccia Web.
days_remaining_until_password_expire	days_remaining_until_password_expire	integer	Numero di giorni rimanenti fino alla scadenza della password
password_expire_at	password_expire_at	string	Data/ora di scadenza password

Scaricare il file

ID operazione:: DownloadFile

Scaricare il file

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Percorso	path	True	string	Percorso su cui operare.

Restituisce

Contenuto del file: binary

Sposta file o cartella

ID operazione:: FileActionMove

Sposta file o cartella

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Percorso	path	True	string	Percorso su cui operare.
Destinazione	destination	True	string	Spostare il percorso di destinazione.

Restituisce

Nome	Percorso	Tipo	Descrizione
status	status	string	Stato dell'operazione file.
file_migration_id	file_migration_id	integer	Se lo stato è in sospeso, si tratta dell'ID della migrazione file per verificare la presenza di aggiornamenti dello stato.

Trova file o cartella in base al percorso

ID operazione:: FileActionFind

Trova file o cartella in base al percorso

Parametri

Nome	Chiave	Necessario	Tipo	Descrizione
Percorso	path	True	string	Percorso su cui operare.

Restituisce

Nome	Percorso	Tipo	Descrizione
path	path	string	Percorso file o cartella. Deve essere delimitato da barre, ma non deve iniziare né terminare con una barra. Massimo 5000 caratteri.
created_by_id	created_by_id	integer	ID utente dell'utente che ha creato il file o la cartella
created_by_api_key_id	created_by_api_key_id	integer	ID della chiave API che ha creato il file o la cartella
created_by_as2_incoming_message_id	created_by_as2_incoming_message_id	integer	ID del messaggio in arrivo AS2 che ha creato il file o la cartella
created_by_automation_id	created_by_automation_id	integer	ID dell'automazione che ha creato il file o la cartella
created_by_bundle_registration_id	created_by_bundle_registration_id	integer	ID della registrazione bundle che ha creato il file o la cartella
created_by_inbox_id	created_by_inbox_id	integer	ID della posta in arrivo che ha creato il file o la cartella
created_by_remote_server_id	created_by_remote_server_id	integer	ID del server remoto che ha creato il file o la cartella
created_by_sync_id	created_by_sync_id	integer	ID della sincronizzazione che ha creato il file o la cartella
custom_metadata	custom_metadata	object	Mappa dei metadati personalizzata di chiavi e valori. Limitato a 32 chiavi, 256 caratteri per chiave e 1024 caratteri per valore.
display_name	display_name	string	Nome visualizzato file o cartella
type	type	string	Tipo: `directory` o `file`.
size	size	integer	Dimensioni file o cartelle
creato_il	created_at	string	Data o ora di creazione del file
last_modified_by_id	last_modified_by_id	integer	ID utente dell'utente che ha modificato l'ultima volta il file o la cartella
last_modified_by_api_key_id	last_modified_by_api_key_id	integer	ID della chiave API che ha modificato l'ultima volta il file o la cartella
last_modified_by_automation_id	last_modified_by_automation_id	integer	ID dell'automazione che ha modificato per l'ultima volta il file o la cartella
last_modified_by_bundle_registration_id	last_modified_by_bundle_registration_id	integer	ID della registrazione bundle che ha modificato l'ultima volta il file o la cartella
last_modified_by_remote_server_id	last_modified_by_remote_server_id	integer	ID del server remoto che ha modificato per l'ultima volta il file o la cartella
last_modified_by_sync_id	last_modified_by_sync_id	integer	ID della sincronizzazione che ha modificato l'ultima volta il file o la cartella
Mtime	mtime	string	Data o ora dell'ultima modifica del file, in base al server. Timestamp dell'ultima operazione di Files.com del file, indipendentemente dal timestamp modificato inviato.
provided_mtime	provided_mtime	string	Data o ora dell'ultima modifica del file, in base al client che l'ha impostata. Files.com consente ai client desktop, FTP, SFTP e WebDAV di impostare le modifiche a volte. Ciò consente la sincronizzazione di Desktop-Cloud<> per mantenere le modifiche in alcuni casi.
crc32	crc32	string	Checksum del file CRC32. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
md5	md5	string	Checksum MD5 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
sha1	sha1	string	Checksum SHA1 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
sha256	sha256	string	Checksum SHA256 del file. Questa operazione viene talvolta ritardata, quindi se si ottiene una risposta vuota, attendere e riprovare.
mime_type	mime_type	string	Tipo MIME. Ciò è determinato dall'estensione del nome file e non viene archiviato separatamente internamente.
region	region	string	Località dell'area
permissions	permissions	string	Stringa breve che rappresenta le autorizzazioni dell'utente corrente. Può essere `r` (lettura),`w` (scrittura),`d` (eliminazione), `l` (elenco) o qualsiasi combinazione
subfolders_locked?	subfolders_locked?	boolean	Le sottocartelle sono bloccate e non possono essere modificate?
is_locked	is_locked	boolean	Questa cartella è bloccata e non può essere modificata?
download_uri	download_uri	string	Collegamento per scaricare il file. Fornito solo in risposta a una richiesta di download.
priority_color	priority_color	string	Colore segnalibro o priorità del file o della cartella
preview_id	preview_id	integer	ID anteprima file
id	preview.id	integer	ID anteprima
status	preview.status	string	Stato anteprima. Può essere non valido, not_generated, generazione, completamento o file_too_large
download_uri	preview.download_uri	string	Collegamento per scaricare l'anteprima
type	preview.type	string	Tipo di anteprima. Può essere immagine, pdf, pdf_native, video o audio
size	preview.size	string	Dimensioni anteprima

Definizioni

binario

Questo è il tipo di dati di base 'binario'.

Condividi tramite

Files.com (anteprima)

Creazione di una connessione

Predefinito

Limiti per la limitazione delle richieste

Azioni

Aggiorna collegamento condivisione

Parametri

Restituisce

Aggiornare la notifica del collegamento di condivisione

Parametri

Restituisce

Aggiornare un gruppo

Parametri

Restituisce

Aggiornare un utente

Parametri

Restituisce

Aggiornare un utente

Parametri

Restituisce

Carica il file

Parametri

Collegamenti di condivisione elenco

Restituisce

Copia file o cartella

Parametri

Restituisce

Crea cartella

Parametri

Restituisce

Crea collegamento di condivisione

Parametri

Restituisce

Crea destinatario collegamento condivisione

Parametri

Restituisce

Crea gruppo

Parametri

Restituisce

Creare un nuovo account utente per il gruppo

Parametri

Restituisce

Creare un utente

Parametri

Restituisce

Creare una notifica di collegamento di condivisione

Parametri

Restituisce

Destinatari dei collegamenti di condivisione elenco

Parametri

Restituisce

Elenca gruppi

Restituisce

Elenca utenti

Restituisce

Elencare cartelle per percorso

Parametri

Restituisce

Elencare i download dei collegamenti di condivisione

Parametri

Restituisce

Elencare le notifiche dei collegamenti di condivisione

Restituisce

Elimina collegamento condivisione

Parametri

Elimina file o cartella

Parametri

Elimina notifica collegamento condivisione

Parametri

Eliminare un gruppo

Parametri

Eliminazione di un utente.

Parametri

List Share Link Registrations

Parametri

Restituisce

Mostra collegamento di condivisione

Parametri

Restituisce