# Firma un file remoto

Firma un file remoto in base ai parametri richiesti. Viene utilizzato il primo certificato di firma rilevato.

Endpoint: GET /signUrl
Version: 2.0.0

## Query parameters:

  - `pin` (string, required)
    PIN del dispositivo.

  - `url` (string, required)
    URL del file da firmare.

  - `type` (string, required)
    Tipo di firma.
    Enum: "cades", "pades", "xades"

  - `result` (string, required)
    Come ottenere l'output.
    Enum: "link", "base64", "upload"

  - `filename` (string,null)

  - `pkcs11` (string,null)
    Sorgente del certificato. Usa pkcs11 per i dispositivi fisici  e system per i certificati di sistema.
    Enum: "pkcs11", "system"

  - `uploadUrl` (string,null)
    Richiesto quando result=upload, rappresenta dove eseguire l'upload.

  - `signerName` (string,null)
    Per firma grafica, nome del firmatarioe.

  - `page` (integer,null)
    Per firma grafica, pagina su cui apporre la firma.

  - `x` (number,null)
    Per firma grafica, posizione orizzontale.

  - `y` (number,null)
    Per firma grafica, posizione verticale.

  - `w` (number,null)
    Per firma grafica, larghezza della firma.

  - `h` (number,null)
    Per firma grafica, altezza della firma.

  - `imageUrl` (string,null)
    Per firma grafica, immagine da usare.

  - `tsaUrl` (string,null)
    Per aggiungere una marca temporale, url del servizio di marca temporale.

  - `tsaUsername` (string,null)
    Per aggiungere una marca temporale, username.

  - `tsaPassword` (string,null)
    Per aggiungere una marca temporale, password.

## Response 200 fields (application/json):

  - `signed` (string, required)