Quickstart

Questa guida ti permette di inviare la tua prima pratica di firma in 5 minuti.

Prerequisiti

• Credenziali API: token X-SignToken e username X-SignUser forniti dall'amministratore
• Un file PDF da far firmare

Non hai le credenziali?

Contatta l'amministratore del tuo tenant Askme Sign. Per i dettagli consulta Autenticazione.

Puoi seguire questa guida in due modi: usando Postman se preferisci un'interfaccia grafica, oppure direttamente da terminale con cURL. Il risultato è lo stesso — scegli quello che ti è più comodo.

---

Postman

Il modo più veloce per esplorare le API senza scrivere codice.

⬇ Scarica la Collection Postman

Step 1: Importa la collection

1. Apri Postman e clicca su Import (in alto a sinistra)
2. Trascina il file .json scaricato oppure clicca Upload Files
3. Conferma l'importazione — troverai la collection Askme Sign — Quickstart nella barra laterale

Step 2: Configura le credenziali

1. Clicca sulla collection e vai nella tab Variables
2. Imposta i valori nelle colonne Current value:

Variabile	Valore
X-SignToken	il tuo token X-SignToken
X-SignUser	il tuo username X-SignUser

3. Clicca Save

Step 3: Verifica le credenziali

Apri la richiesta Step 1 — Verifica le credenziali e clicca Send.

Dovresti ricevere i dati del tuo account (nome, email, permessi). Se ottieni un errore 401, verifica i valori delle variabili.

Step 4: Prepara il documento in Base64

Prima di creare la pratica devi codificare il tuo PDF in Base64. Puoi farlo in tre modi:

Da terminale:

# Linux/macOS
base64 -i contratto.pdf | tr -d '\n'

# Windows (PowerShell)
[Convert]::ToBase64String([IO.File]::ReadAllBytes("contratto.pdf"))

Online (senza installare nulla): carica il file su base64.guru o base64encode.org e copia il risultato.

Step 5: Crea la pratica

1. Apri la richiesta Step 2 — Crea la pratica
2. Nella tab Body, sostituisci INSERISCI_IL_PDF_IN_BASE64 con il contenuto Base64 del tuo PDF
3. Modifica i dati del firmatario (firstName, lastName, email) con quelli reali
4. Clicca Send

Dopo l'invio, l'id_file viene salvato automaticamente nelle variabili della collection e usato nei passi successivi.

suggerimento

Nella risposta trovi anche il signingUrl da condividere al firmatario se hai impostato sendNotifications: false.

Step 6: Controlla lo stato

Apri la richiesta Step 3 — Controlla lo stato e clicca Send.

Stato	Significato
L	In lavorazione — in attesa di firma
A	Completato — tutte le firme completate
R	Rifiutato
E	Scaduto

Step 7: Scarica il documento firmato

Quando lo stato è A, apri la richiesta Step 4 — Scarica il documento firmato e clicca Send.

Per salvare il PDF: clicca sulla freccia accanto a Send → Send and Download.

cURL

Step 1: Verifica le credenziali

curl -s "https://sign.askme.it/api/v2/account" \
  -H "X-SignToken: YOUR_TOKEN" \
  -H "X-SignUser: YOUR_USERNAME" | jq .

Dovresti ricevere i dati del tuo account. Se ottieni un errore 401, verifica le credenziali.

Step 2: Prepara il documento

Codifica il tuo PDF in Base64:

# Linux/macOS
base64 -i contratto.pdf | tr -d '\n' > contratto_b64.txt

# Windows (PowerShell)
[Convert]::ToBase64String([IO.File]::ReadAllBytes("contratto.pdf")) > contratto_b64.txt

Online (senza installare nulla): carica il file su un convertitore come base64.guru o base64encode.org e copia il risultato.

Step 3: Crea la pratica

curl -X POST "https://sign.askme.it/api/v2/files/send" \
  -H "X-SignToken: YOUR_TOKEN" \
  -H "X-SignUser: YOUR_USERNAME" \
  -H "Content-Type: application/json" \
  -d '{
    "documents": [
      {
        "filename": "contratto.pdf",
        "base64content": "CONTENUTO_BASE64_DEL_PDF"
      }
    ],
    "name": "Test Quickstart",
    "sendNotifications": true,
    "expirationDateDays": 7,
    "signers": [
      {
        "firstName": "Mario",
        "lastName": "Rossi",
        "email": "[email protected]",
        "action": "S",
        "signatureCoordinates": [
          {
            "document": 0,
            "page": 1,
            "signatureType": "S",
            "positionX": 0.6,
            "positionY": 0.8,
            "width": 0.2,
            "height": 0.08
          }
        ]
      }
    ]
  }'

La risposta contiene l'ID della pratica e il link di firma:

{
  "idFile": 12345,
  "signers": [
    {
      "email": "[email protected]",
      "signingUrl": "https://sign.askme.it/external-sign?token=abc123..."
    }
  ]
}

Il firmatario riceverà un'email con il link (se sendNotifications: true). In alternativa, condividi direttamente il signingUrl.

Tipi di firma

In questo esempio usiamo "action": "S" (firma semplice). Per scegliere il tipo più adatto consulta Tipi di Firma.

Step 4: Controlla lo stato

curl -s "https://sign.askme.it/api/v2/files/12345" \
  -H "X-SignToken: YOUR_TOKEN" \
  -H "X-SignUser: YOUR_USERNAME" | jq '{status, name}'

Stato	Significato
L	In lavorazione — in attesa di firma
F	Firmato
A	Completato
R	Rifiutato
E	Scaduto

Step 5: Scarica il documento firmato

Quando lo stato è A, scarica il documento:

curl -X GET "https://sign.askme.it/api/v2/files/download/12345" \
  -H "X-SignToken: YOUR_TOKEN" \
  -H "X-SignUser: YOUR_USERNAME" \
  -o contratto-firmato.pdf

---

Prossimi passi

Cosa fare	Dove leggere
Vedere tutti gli endpoint disponibili	API Endpoints
Capire quale tipo di firma usare	Tipi di Firma
Aggiungere campi compilabili ai documenti	Placeholder
Usare template predefiniti per pratiche ricorrenti	Tipologie di Processo
Ricevere notifiche in tempo reale	Webhooks
Vedere esempi completi in Python, JavaScript e cURL	Esempi
Consultare la specifica OpenAPI/Swagger	OpenAPI