Digitale und elektronische Signaturen, Massensignaturen und digitale Identitäten - alles in einer API verfügbar
Fordern Sie SPID, elektronische Signaturen oder jede Art von digitaler Signatur an, egal ob Smartcard, USB oder Remote, um Computerdokumenten einen rechtlichen Wert zu verleihen.
All das Wissen, das Sie benötigen
Hier finden Sie einige Ratschläge, die Sie berücksichtigen sollten, um sich dieser API zu nähern. Wenn Sie möchten, bieten wir Code-Beispiele, OAS3-Dokumentation, die Möglichkeit, die API live über Swagger UI auszuprobieren oder die gesamte Sammlung in Postman zu importieren. Wir bieten auch eine Sandbox-Umgebung an, in der Sie kostenlos mit allen Arten von Anfragen experimentieren können.
Holen Sie sich das Token im entsprechenden Abschnitt, bevor Sie beginnen.
- Oas file url https://console.openapi.com/oas/de/firmadigitale.openapi.json
- Fork or import with Postman
- Production domain ws.firmadigitale.com
- Sandbox domain test.ws.firmadigitale.com
-
Production Scopes 9
- GET ws.firmadigitale.com/prodotti
- POST ws.firmadigitale.com/firma_elettronica
- GET ws.firmadigitale.com/richiesta
- POST ws.firmadigitale.com/richiesta
- PATCH ws.firmadigitale.com/richiesta
- GET ws.firmadigitale.com/firma_elettronica
- GET ws.firmadigitale.com/firma_elettronica_ui
- POST ws.firmadigitale.com/firma_elettronica_ui
- GET ws.firmadigitale.com/spid_personale
-
Sandbox Scopes 9
- GET test.ws.firmadigitale.com/richiesta
- POST test.ws.firmadigitale.com/richiesta
- GET test.ws.firmadigitale.com/prodotti
- PATCH test.ws.firmadigitale.com/richiesta
- POST test.ws.firmadigitale.com/firma_elettronica
- GET test.ws.firmadigitale.com/firma_elettronica
- GET test.ws.firmadigitale.com/firma_elettronica_ui
- POST test.ws.firmadigitale.com/firma_elettronica_ui
- GET test.ws.firmadigitale.com/spid_personale
Firma Digitale (1.0.0)
Webdienst, der es Ihnen ermöglicht, digitale Signaturen von Infocert oder Aruba zu erwerben oder zu erneuern und digitale Identitäten zu erhalten.
Liste der Produkte
Diese Methode zeigt Ihnen die Liste aller unserer Produkte
Authorizations:
Responses
Response Schema: application/json
Array of objects (Prodotto) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/prodotti"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- "data": [
- {
- "nome": "Spid - Identità Digitale",
- "tipo": "Infocert",
- "codice_prodotto": "SPID",
- "prezzo": 14.2
- {
- "nome": "Rinnovo Certificato Firma",
- "tipo": "Infocert",
- "codice_prodotto": "RINFIR",
- "prezzo": 9
- {
- "nome": "Business Key",
- "tipo": "Infocert",
- "codice_prodotto": "KEY",
- "prezzo": 40
- {
- "nome": "Lettore Smart Card USB",
- "tipo": "Infocert",
- "codice_prodotto": "LETTORE",
- "prezzo": 13,
- "vergine": true
- {
- "nome": "Kit Firma Digitale",
- "tipo": "Infocert",
- "codice_prodotto": "KIT",
- "prezzo": 39.7
- {
- "nome": "Firma Digitale Remota Infocert",
- "tipo": "Infocert",
- "codice_prodotto": "FIRREM",
- "prezzo": 25.7
- {
- "nome": "Business Key CNS",
- "tipo": "Infocert",
- "codice_prodotto": "KEYCNS",
- "prezzo": 40.7
- {
- "nome": "Smart Card Infocert CNS",
- "tipo": "Infocert",
- "codice_prodotto": "SMARTCARDCNS",
- "prezzo": 25.7
- {
- "nome": "Rinnovo CNS Infocert",
- "tipo": "Infocert",
- "codice_prodotto": "RINCNS",
- "prezzo": 9
- {
- "nome": "Kit CNS Infocert",
- "tipo": "Infocert",
- "codice_prodotto": "KITCNS",
- "prezzo": 40.3
- {
- "nome": "Smart Card Aruba CNS",
- "tipo": "Aruba",
- "codice_prodotto": "SCARUBACNS",
- "prezzo": 22.4
- {
- "nome": "Aruba Key CNS",
- "tipo": "Aruba",
- "codice_prodotto": "ARUBAKEYCNS",
- "prezzo": 39.4
- {
- "nome": "Firma Aruba OTP Display",
- "tipo": "Aruba",
- "codice_prodotto": "OTPDIS",
- "prezzo": 25.2
- {
- "nome": "Firma Aruba OTP Mobile",
- "tipo": "Aruba",
- "codice_prodotto": "OTPMOB",
- "prezzo": 21.7
- {
- "nome": "Firma Estero",
- "tipo": "Infocert",
- "codice_prodotto": "FIREST",
- "prezzo": 49.7
- {
- "nome": "Videoriconoscimento Aruba",
- "tipo": "Aruba",
- "codice_prodotto": "VIDEORIC",
- "prezzo": 15
- {
- "nome": "Firma Digitale",
- "tipo": "Infocert",
- "codice_prodotto": "FIR",
- "prezzo": 22.7
- {
- "nome": "Spid Vergine - Identità Digitale",
- "tipo": "Infocert",
- "codice_prodotto": "SPID_V",
- "prezzo": 14.2,
- "vergine": true
- {
- "nome": "Firma Digitale Vergine",
- "tipo": "Infocert",
- "codice_prodotto": "FIR_V",
- "prezzo": 22.7,
- "vergine": true
- {
- "nome": "Business Key Vergine",
- "tipo": "Infocert",
- "codice_prodotto": "KEY_V",
- "prezzo": 40,
- "vergine": true
- {
- "nome": "Firma Digitale Remota Infocert Vergine",
- "tipo": "Infocert",
- "codice_prodotto": "FIRREM_V",
- "prezzo": 25.7,
- "vergine": true
- {
- "nome": "Business Key CNS Vergine",
- "tipo": "Infocert",
- "codice_prodotto": "KEYCNS_V",
- "prezzo": 40.7,
- "vergine": true
- {
- "nome": "Smart Card Infocert CNS Vergine",
- "tipo": "Infocert",
- "codice_prodotto": "SMARTCARDCNS_V",
- "prezzo": 25.7,
- "vergine": true
- {
- "nome": "Smart Card Infocert CNS Con Videoriconoscimento",
- "tipo": "Infocert",
- "codice_prodotto": "SMARTCARDCNS_VIDEO",
- "prezzo": 57.9
- {
- "nome": "Business Key CNS Con Videoricoscimento",
- "tipo": "Infocert",
- "codice_prodotto": "KEYCNS_VIDEO",
- "prezzo": 77.9
- {
- "nome": "Firma Digitale Remota Infocert Con Videoriconoscimento",
- "tipo": "Infocert",
- "codice_prodotto": "FIRREM_VIDEO",
- "prezzo": 63.7
- {
- "nome": "Rinnovo Firma Remota",
- "tipo": "Infocert",
- "codice_prodotto": "RINFIRREM",
- "prezzo": 19.7
- {
- "nome": "Spid Personale",
- "tipo": "Namirial",
- "codice_prodotto": "SPID_PER",
- "prezzo": 14.2
- "success": true,
- "message": "",
- "error": null
Erwerb und Erneuerung digitaler Signaturen
Mit dieser Methode können Sie alle Produkte dieses Webdienstes erwerben, z. B. Smartcard-Lesegeräte oder digitale Signaturen.
Authorizations:
path Parameters
codice_prodotto required | string Example: FIR Typ des codice_prodotto, den Sie kaufen möchten |
Request Body schema: application/json
Verweisungsschemata für Kategorien:
- PostBodySpid: SPID oder SPID_V
- PostBodyFirmaEstero: FIREST
- PostBodyLettore: FIR_V oder LETTORE oder KEY_V oder FIRREM_V oder KEYCNS_V oder SMARTCARDCNS_V
- PostBodyRinnovi: RINFIR oder RINCNS oder RINFIRREM
- PostBodyFirme: FIR oder KIT oder KEY oder FIRREM oder KEYCNS oder KITCNS oder SMARTCARDCNS
- PostBodyFirmeVideoriconoscimento: SMARTCARDCNS_VIDEO oder KEYCNS_VIDEO oder FIRREM_VIDEO
- PostBodyVideoriconoscimento: VIDEORIC
- PostBodyFirmeAruba: SCARUBACNS oder ARUBAKEYCNS oder OTPDIS oder OTPMOB
assistenza | boolean Produkthilfe |
object (Callback) |
Responses
Response Schema: application/json
ResponseRinnovo (object) or ResponseFirmaEstero (object) or ResponseFirma (object) or ResponseLettore (object) or ResponseSpid (object) or ResponseFirmeVideoriconoscimento (object) or ResponseFirmeAruba (object) | |
success | boolean |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "assistenza": true,
- "urgenza": true,
- "spedizione": "veloce",
- "anagrafica_spedizione": {
- "cellulare": "349xxxxx18",
- "destinatario": "alberto neri",
- "indirizzo_spedizione": "via rossi 2",
- "comune_spedizione": "terni",
- "provincia_spedizione": "terni",
- "cap_spedizione": "05100"
Response samples
- 200
- 400
- 402
- 406
- 428
- "data": {
- "videoriconoscimento": true,
- "documento": true,
- "anagrafica": {
- "nome": "alberto",
- "cognome": "neri",
- "cellulare": "349xxxxx18",
- "codice_fiscale": "vnxxxxxxxl1x7d",
- "data_nascita": "28/12/2000",
- "sesso": "M",
- "comune_nascita": "terni",
- "provincia_nascita": "terni",
- "nazione_nascita": "terni",
- "indirizzo_residenza": "via rossi 2",
- "comune_residenza": "terni",
- "provincia_residenza": "terni",
- "cap_residenza": "05100",
- "nazione_residenza": "italia",
- "destinatario": "alberto neri",
- "indirizzo_spedizione": "via rossi 2",
- "comune_spedizione": "terni",
- "provincia_spedizione": "terni",
- "cap_spedizione": "05100",
- "tipo_documento": "patente",
- "numero_documento": "123456",
- "soggetto_emittente": "mctc",
- "data_emissione": "05/11/1990",
- "data_scadenza": "12/12/2020"
- "callback": {
- "method": "JSON",
- "field": "data",
- "data": { }
- "codice_richiesta": "d1e4a",
- "prodotto": "Smart Card Aruba CNS",
- "codice_prodotto": "SCARUBACNS",
- "tipo": "Aruba",
- "stato": "in_registrazione",
- "timestamp": {
- "acquisto": 1602587629
- "urgenza": false,
- "quantita": 1,
- "spedizione": "ordinaria",
- "assistenza": false,
- "fornitore": {
- "ragione_sociale": "Openapi Srl",
- "sede_legale": "Viale F. Tommaso Marinetti 221 - 00143 Roma (RM)",
- "partita_iva": "07432261001",
- "legale_rappresentante": "",
- "email_assistenza": "",
- "email_contabilita": "",
- "telefono_assistenza": "",
- "sede_riconoscimento": "Piazza San Giovanni Decollato 6 - 05100 Terni (TR)"
- "firma": {
- "codice_spedizione": "",
- "pin": "",
- "puk": "",
- "numero_dispositivo": "",
- "codice_carta": "",
- "numero_busta": "",
- "codice_utente": "",
- "iut": "",
- "alias": "",
- "codice_emergenza": ""
- "id": "5f7ef1e83a716836d3152662",
- "modulo": false
- "success": true,
- "message": "",
- "error": null
Liste Ihrer Anfragen
Diese Methode zeigt Ihnen die Liste aller Ihrer Anfragen
Authorizations:
query Parameters
codice_prodotto | string Example: codice_prodotto=FIR Art des Codes_prodotto |
Responses
Response Schema: application/json
Array of objects (Richieste) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/richiesta?codice_prodotto=FIR"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- 404
- "data": [
- {
- "_id": "5f774d903a71681fce3c71d3",
- "assistenza": true,
- "urgenza": true,
- "spedizione": "veloce",
- "codice_richiesta": 1,
- "prodotto": "Firma Digitale",
- "codice_prodotto": "FIR",
- "tipo": "Infocert",
- "stato": "in_riconoscimento",
- "timestamp": {
- "acquisto": 1602587629,
- "emissione": 1602587629,
- "evasione": 1602587629,
- "scadenza": 1791890029
- "owner": "[email protected]"
- {
- "_id": "5f7b1f8b3a716857774a4362",
- "assistenza": true,
- "urgenza": false,
- "spedizione": false,
- "codice_richiesta": 6,
- "prodotto": "Rinnovo Certificato Firma",
- "codice_prodotto": "RINFIR",
- "tipo": "Infocert",
- "stato": "evasa",
- "timestamp": {
- "acquisto": 1602587629,
- "emissione": 1602587629,
- "evasione": 1602587629,
- "scadenza": 1791890029
- "owner": "[email protected]"
- "success": true,
- "message": "",
- "error": null
Besondere Anfrage
Diese Methode zeigt Ihnen die spezifische Anfrage, die mit der id
Authorizations:
path Parameters
id required | string Example: 5f7b2e323a716857774a4373 Anfrage-ID |
Responses
Response Schema: application/json
ResponseRinnovo (object) or ResponseFirmaEstero (object) or ResponseFirma (object) or ResponseLettore (object) or ResponseSpid (object) or ResponseFirmeVideoriconoscimento (object) or ResponseFirmeAruba (object) | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/richiesta/%7Bid%7D"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- 400
- 404
Das gleiche Beispiel für /FIR_V /LETTORE /KEY_V /FIRREM_V /KEYCNS_V /SMARTCARDCNS_V
- "data": {
- "anagrafica_spedizione": {
- "cellulare": "349xxxxx18",
- "destinatario": "alberto neri",
- "indirizzo_spedizione": "via rossi 2",
- "comune_spedizione": "terni",
- "provincia_spedizione": "terni",
- "cap_spedizione": "05100",
- "note": ""
- "callback": {
- "method": "JSON",
- "field": "data",
- "data": { }
- "codice_richiesta": "c335c",
- "prodotto": "Smart Card Infocert CNS Vergine",
- "codice_prodotto": "SMARTCARDCNS_V",
- "tipo": "Infocert",
- "stato": "in_lavorazione",
- "assistenza": false,
- "urgenza": false,
- "spedizione": "ordinaria",
- "videoriconoscimento": false,
- "quantita": 1,
- "timestamp": {
- "acquisto": 1602587629
- "fornitore": {
- "ragione_sociale": "Openapi Srl",
- "sede_legale": "Viale F. Tommaso Marinetti 221 - 00143 Roma (RM)",
- "partita_iva": "07432261001",
- "legale_rappresentante": "",
- "email_assistenza": "",
- "email_contabilita": "",
- "telefono_assistenza": "",
- "sede_riconoscimento": "Piazza San Giovanni Decollato 6 - 05100 Terni (TR)"
- "firma": {
- "codice_spedizione": "",
- "pin": "",
- "puk": "",
- "numero_dispositivo": "",
- "codice_carta": "",
- "numero_busta": "",
- "codice_utente": "",
- "iut": "",
- "alias": "",
- "codice_emergenza": ""
- "id": "5f7ef1e83a716836d3152662",
- "modulo": false,
- "documento": false
- "success": true,
- "message": "",
- "error": null
Antrag auf Aktualisierung
Mit dieser Methode können Sie das Formular und das Ausweisdokument hochladen
Authorizations:
path Parameters
id required | string Example: 5f7b2e323a716857774a4373 Anfrage-ID |
Request Body schema: application/json
documento | string ID-Dokumentdatei kodiert in Base 64 |
nome_documento | string Name der Datei |
modulo | string Erkennungsformulardatei kodiert in Base 64 |
nome_modulo | string Name der Datei |
Responses
Response Schema: application/json
ResponseFirma (object) or ResponseFirmeAruba (object) | |
success | boolean |
message | string |
error | integer |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "modulo": "MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwGggCSABIID6CVQREYtMS40CiXi48/TCjEgMCBvYmoKPDwvRmlsdGVyL0ZsYXRlRGVjb2RlL0xlbmd0aCAyNTgyL04gMz4+c3RyZWFtCnictVZnVFPZFj733vRCCyCd0GuQTgDpvUmRLiohCRBKgJAAKnZEBUYQEWkWkEERBxyVImNBLFgYFBRRQSfIoKCOgwUbKu8Gf+is9db7Ne9b69773W/tvc8++/w4HwDkqTR2ejYMAEjnCwVhPu706JhYOv4+QIAqUAC6QJPFzs50Cw",
- "nome_modulo": "modulo.pdf",
- "documento": "YCQEUVEC2EgTMQDCUZikUREgKxHipBKpAFpRbqRPuQ2IkZeIB8xOAwNQ8cwMI4YX0wEho3JwqzHlGBqMEcwHZhLmNuYccwM5iuWilXDmmAdsH7YaGwSNhdbiK3ENmHbsZexw9hJ7DscDqeIM8DZ4XxxMbgU3FpcCW4frg3XgxvETeBm8Xi8Mt4E74QPxrPwQnwhvhp/DH8eP4SfxH8gkAmaBEuCNyGWwCdsJlQSjhLOEYYITwlzRBmiHtGBGEzkEFcTS4mNxG7iTeIkcY4kSzIgOZHCSSmkTaQqUivpMmmM9IZMJmuT7cmhZB55I7mKfJx8lTxO/kiRoxhTPChxFBFlJ+UwpYdyn/KGSqXqU12psVQhdSe1",
- "nome_documento": "documento.pdf"
Response samples
- 200
- 400
- 404
- 406
- 428
Das gleiche Beispiel für /KEY /FIR /KIT /FIRREM /KEYCNS /KITCNS /SMARTCARDCNS
- "data": {
- "anagrafica": {
- "nome": "alberto",
- "cognome": "neri",
- "cellulare": "349xxxxx18",
- "codice_fiscale": "vnxxxxxxxl1x7d",
- "data_nascita": "28/12/2000",
- "sesso": "M",
- "comune_nascita": "terni",
- "provincia_nascita": "terni",
- "nazione_nascita": "terni",
- "indirizzo_residenza": "via rossi 2",
- "comune_residenza": "terni",
- "provincia_residenza": "terni",
- "cap_residenza": "05100",
- "nazione_residenza": "italia",
- "destinatario": "alberto neri",
- "indirizzo_spedizione": "via rossi 2",
- "comune_spedizione": "terni",
- "provincia_spedizione": "terni",
- "cap_spedizione": "05100",
- "tipo_documento": "patente",
- "numero_documento": "123456",
- "soggetto_emittente": "mctc",
- "data_emissione": "05/11/1990",
- "data_scadenza": "12/12/2020",
- "note": ""
- "callback": {
- "method": "JSON",
- "field": "data",
- "data": { }
- "codice_richiesta": "8417d",
- "prodotto": "Firma Digitale Remota Infocert",
- "codice_prodotto": "FIRREM",
- "tipo": "Infocert",
- "stato": "in_riconoscimento",
- "timestamp": {
- "acquisto": 1602587629,
- "registrazione": 1681226069
- "assistenza": false,
- "urgenza": false,
- "spedizione": "veloce",
- "videoriconoscimento": false,
- "quantita": 1,
- "fornitore": {
- "ragione_sociale": "Openapi Srl",
- "sede_legale": "Viale F. Tommaso Marinetti 221 - 00143 Roma (RM)",
- "partita_iva": "07432261001",
- "legale_rappresentante": "",
- "email_assistenza": "",
- "email_contabilita": "",
- "telefono_assistenza": "",
- "sede_riconoscimento": "Piazza San Giovanni Decollato 6 - 05100 Terni (TR)"
- "firma": {
- "codice_spedizione": "",
- "pin": "",
- "puk": "",
- "numero_dispositivo": "",
- "codice_carta": "",
- "numero_busta": "",
- "codice_utente": "",
- "iut": "",
- "alias": "",
- "codice_emergenza": ""
- "id": "5f7ef1e83a716836d3152662",
- "modulo": true,
- "documento": true
- "success": true,
- "message": "",
- "error": null
Download des Anerkennungsformulars
Mit dieser Methode können Sie direkt das Anerkennungsformular im pdf-Format herunterladen, das dann ausgefüllt und von raccomandata an den fornitore geschickt werden muss; es ist unerlässlich, um die Umgehung eines Verfahrens zum Erwerb einer digitalen Signatur zu vervollständigen; es ist nicht für die Erneuerung einer Signatur erforderlich
Authorizations:
path Parameters
id required | string Example: 5f7b2e323a716857774a4373 Anfrage-ID |
Responses
Response Schema: application/pdf
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/richiesta/%7Bid%7D/modulo"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
E-Signatur anfordern
Mit diesem Dienst können Sie eine PDF-Datei von mehreren Benutzern mit Zustimmungsnachweis digital signieren.
Wir stellen Ihnen einen Link zur Verfügung, den Sie einfach in einen iframe einbinden können, der Ihre Benutzer während des Signiervorgangs leitet; sie erhalten eine SMS an die angegebene Telefonnummer mit einem OTP, um ihre Identität zu überprüfen.
Das signierte Dokument wird von den europäischen Vorschriften anerkannt.
Um die Koordinaten für Ihre Vorlagen zu finden, prüfen Sie bitte unser Online-Tool unter: https://developers.openapi.it/playground/firmadigitale/
Ihre Anfrage wird einen Statusparameter zurückgeben, der sich bei jeder Aktualisierung ändert.
Wenn fertig zurückgegeben wird, ist Ihre Anfrage abgeschlossen und alle Mitglieder haben das Dokument unterzeichnet; wenn abgelehnt zurückgegeben wird, bedeutet dies, dass einer Ihrer Unterzeichner das Dokument absichtlich abgelehnt hat.
Wenn Sie einen Callback registrieren, wird jedes Mal eine POST-Anfrage an Ihren Server gesendet, wenn sich der Status der Anfrage ändert oder eines Ihrer Mitglieder das Dokument unterzeichnet/abgelehnt hat. Sie können den Status jederzeit mit einer GET-Anfrage überprüfen
Authorizations:
Request Body schema: application/json
title | string or null Sie können einen Titel und eine Beschreibung für Ihre Anfrage angeben. Sie werden den Nutzern während des Unterzeichnungsprozesses in dem Iframe angezeigt |
description | string or null |
ui | string Eine mit /firma_elettronica_ui erstellte UI-Konfiguration |
filename | string Default: "fes_{timestamp}.pdf" |
content | string base64-Kodierung Ihrer PDF-Datei |
Array of objects | |
object (FesCallback) |
Responses
Response Schema: application/json
object (FesBaseResponse) | |
success | boolean |
message | string |
error | string |
Callbacks
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "title": "string",
- "description": "string",
- "ui": "string",
- "filename": "fes_{timestamp}.pdf",
- "content": "string",
- "members": [
- {
- "firstname": "string",
- "lastname": "string",
- "email": "string",
- "phone": "string",
- "signs": [
- {
- "page": 0,
- "position": "10,15,45,35"
- "callback": {
- "field": "string",
- "headers": {
- "key": "value"
Response samples
- 200
- "filename": "example.pdf",
- "members": [
- "content": "JVBERi0xLjUKJb/3ov4KNiAwIG9iago8PCAvTGluZWFyaXplZCAxIC9MIDUwMTY4IC9IIFsgNzA4IDE0NCBdIC9PIDEwIC9FIDQ0NTc4IC9OIDIgL1QgNDk4NzIgPj4KZW5kb2JqCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICA..."
Callback payload samples
- "data": {
- "id": "string",
- "filename": "fes_{timestamp}.pdf",
- "title": "string",
- "description": "string",
- "members": [
- {
- "firstname": "string",
- "lastname": "string",
- "email": "string",
- "phone": "string",
- "status": "string",
- "createdAt": 0,
- "updatedAt": 0,
- "sign_link": "string"
- "status": "created",
- "download_link": "string"
Auflistung aller Ihrer früheren und noch offenen Anfragen
Authorizations:
Responses
Response Schema: application/json
Array of objects (FesBaseResponse) | |
success | boolean |
message | string |
error | string |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- "data": [
- {
- "id": "string",
- "filename": "fes_{timestamp}.pdf",
- "title": "string",
- "description": "string",
- "members": [
- {
- "firstname": "string",
- "lastname": "string",
- "email": "string",
- "phone": "string",
- "status": "string",
- "createdAt": 0,
- "updatedAt": 0,
- "sign_link": "string"
- "status": "created",
- "download_link": "string",
- "callback_status": "string",
- "callback": {
- "method": "string",
- "field": "string",
- "url": "string"
- "success": true,
- "message": "string",
- "error": "string"
Informationen zu einem Schilderantrag erhalten
Authorizations:
path Parameters
id required | string Example: 923j90n02n1w51504b6ea145 |
Responses
Response Schema: application/pdf
object (FesBaseResponse) | |
success | boolean |
message | string |
error | string |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica/%7Bid%7D"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Laden Sie Ihr unterzeichnetes Dokument herunter
Sobald der Signiervorgang abgeschlossen ist, können Sie diesen Endpunkt verwenden, um die base64-kodierte Ausgabe Ihrer PDF-Datei zu erhalten.
Authorizations:
path Parameters
id required | string Example: 923j90n02n1w51504b6ea145 |
Responses
Response Schema: application/json
content | string Eine base64-Kodierung Ihrer SIGNIERTEN PDF-Datei. |
success | boolean |
message | string |
error | string |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica/%7Bid%7D/download"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- 400
- "content": "aHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g/dj1kUXc0dzlXZ1hjUQ==",
- "success": true,
- "message": "string",
- "error": "string"
Erstellen einer benutzerdefinierten Benutzeroberfläche für elektronische Signaturen
Authorizations:
Request Body schema: application/json
name | string |
description | string |
defaultZoom | integer |
logo | string Ein Base-64-kodiertes Bild, dem das Daten-URI-Schema vorangestellt ist |
languages | Array of strings |
defaultLanguage | string |
signImageTypesAvailable | Array of strings |
enableHeaderBar | boolean |
enableHeaderBarSignAs | boolean |
enableSidebar | boolean |
enableMemberList | boolean |
enableDocumentList | boolean |
enableDocumentDownload | boolean |
enableActivities | boolean |
authenticationPopup | boolean |
enableRefuseComment | boolean |
Array of objects Passen Sie den Inhalt bestimmter Elemente im iFrame an, indem Sie den Inhalt einiger Bezeichnungen außer Kraft setzen. Jede verfügbare Sprache sollte ihre eigene übersetzte Zeichenfolge haben, sonst wird die Standardbezeichnung angezeigt. | |
fonts | Array of strings |
style | string Die folgenden Klassen sind verfügbar:
|
object | |
object | |
object Sie können die Erfahrung nach der Unterschrift, dem Abbruch oder einem Fehler während des Prozesses anpassen. Verwenden Sie redirectSuccess, um einen Benutzer zu einer URL umzuleiten, wenn er erfolgreich signiert hat. Geben Sie das URL-Feld und die Art und Weise an, wie es im Zielfeld geöffnet werden soll, wie ein HTML-Link. Wenn Sie im Iframe eine Schaltfläche mit folgendem Text anzeigen möchten: "Sie haben erfolgreich signiert, klicken Sie hier, um fortzufahren", setzen Sie ihn auf false. Standardmäßig wird die Weiterleitung bei true automatisch ausgelöst, wenn das Ereignis ebenfalls ausgelöst wird. 2 weitere Weiterleitungen können Sie anpassen: redirectCancel, wenn das Mitglied Ihre Prozedur ablehnt und redirectError, wenn während des Unterzeichnungsprozesses ein Fehler auftritt. |
Responses
Response Schema: application/json
object (FesUiResponse) | |
success | boolean |
message | string |
error | string |
Request samples
- Payload
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
- "name": "My first template for Signature-UI",
- "description": "Hier ist die Signatur-UI-Vorlage für Yousign-Entwickler.",
- "defaultZoom": 100,
- "logo": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQU [...] IwU3i6foIAAAAAElFTkSuQmCC",
- "languages": [
- "fr",
- "en",
- "es",
- "de",
- "it",
- "pt",
- "nl"
- "defaultLanguage": "en",
- "signImageTypesAvailable": [
- "name",
- "draw"
- "enableHeaderBar": true,
- "enableHeaderBarSignAs": true,
- "enableSidebar": true,
- "enableMemberList": true,
- "enableDocumentList": true,
- "enableDocumentDownload": true,
- "enableActivities": true,
- "authenticationPopup": true,
- "enableRefuseComment": true,
- "labels": [
- {
- "name": "NAME OF THE LABEL",
- "languages": {
- "en": "Label en",
- "fr": "Label fr"
- "fonts": [
- "Roboto",
- "Lato"
- "style": "Just a CSS string for customize all of our iFrame.",
- "redirectCancel": {
- "target": "_top or _blank or _self or _parent",
- "auto": false
- "redirectError": {
- "target": "_top or _blank or _self or _parent",
- "auto": false
- "redirectSuccess": {
- "target": "_top or _blank or _self or _parent",
- "auto": false
Response samples
- 200
- "data": {
- "id": "62837d5796b1d9921a426f79c",
- "name": "My custom template",
- "description": ""
- "success": true,
- "message": "",
- "error": null
Alle Ihre benutzerdefinierten Benutzeroberflächen auflisten
Authorizations:
Responses
Response Schema: application/json
Array of objects (FesUiResponse) | |
success | boolean |
message | string |
error | string |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica_ui"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- "data": [
- {
- "id": "62837d5796b1d9921a426f79c",
- "name": "My custom template",
- "description": "Vorlage für Mr Doe"
- {
- "id": "62837d5796b1d9921a426f79c",
- "name": "My second custom template",
- "description": "Vorlage für Herrn John"
- "success": true,
- "message": "",
- "error": null
Benutzerdefinierte UI für elektronische Signaturen erhalten
Authorizations:
path Parameters
id required | string Example: 923j90n02n1w51504b6ea145 Die ID einer UI-Vorlage |
Responses
Response Schema: application/json
object (FesCreateUi) Die folgenden Optionen können angegeben werden:
|
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/firma_elettronica_ui/%7Bid%7D"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- "data": {
- "name": "Test template",
- "description": null,
- "enableHeaderBar": false,
- "enableHeaderBarSignAs": false,
- "enableSidebar": false,
- "enableMemberList": true,
- "enableDocumentList": true,
- "enableDocumentDownload": true,
- "enableActivities": true,
- "enableRefuseComment": true,
- "authenticationPopup": false,
- "defaultZoom": null,
- "logo": null,
- "defaultLanguage": null,
- "signImageTypesAvailable": [ ],
- "languages": [ ],
- "labels": [ ],
- "fonts": [ ],
- "style": null,
- "redirectCancel": null,
- "redirectError": null,
- "redirectSuccess": null
- "success": true,
- "message": "",
- "error": null
Methoden, mit denen Sie 4 Arten von Spid erhalten können (derzeit ist nur die persönliche Spid verfügbar)
Persönlicher Spid
Mit dieser Methode können Sie eine Url für die Registrierung einer persönlichen Kennung mit einer Laufzeit von 1 Jahr erhalten
Authorizations:
Responses
Response Schema: application/json
object | |
success | boolean |
message | string |
error | integer |
Request samples
- C + Libcurl
- Csharp + Restsharp
- Go + Native
- Java + Okhttp
- Java + Unirest
- Javascript + Jquery
- Javascript + Xhr
- Node + Native
- Node + Request
- Node + Unirest
- Objc + Nsurlsession
- Ocaml + Cohttp
- Php + Curl
- Php + Http1
- Php + Http2
- Python + Python3
- Python + Requests
- Ruby + Native
- Shell + Curl
- Shell + Httpie
- Shell + Wget
- Swift + Nsurlsession
CURL *hnd = curl_easy_init(); curl_easy_setopt(hnd, CURLOPT_CUSTOMREQUEST, "GET"); curl_easy_setopt(hnd, CURLOPT_URL, "https://ws.firmadigitale.com/spid_personale"); struct curl_slist *headers = NULL; headers = curl_slist_append(headers, "Authorization: Bearer REPLACE_BEARER_TOKEN"); curl_easy_setopt(hnd, CURLOPT_HTTPHEADER, headers); CURLcode ret = curl_easy_perform(hnd);
Response samples
- 200
- 402
- 422
- "message": "",
- "success": true,
- "error": null