Signatures numériques, électroniques, massives et identités numériques disponibles dans une seule API
Demandez un SPID, une signature électronique ou tout autre type de signature numérique, qu'il s'agisse d'une carte à puce, d'une carte USB ou d'une signature à distance, afin de conférer une valeur juridique à des documents informatiques.
Le délai de réponse du service est de moins de 10 secondes.
Vous pouvez demander les types de signatures suivants:
- Signatures numériques et à distance InfoCert et leurs renouvellements respectifs
- Signatures numériques et à distance Aruba et leurs renouvellements respectifs
- Signature électronique simplifiée
Grâce à l'API Signature Numérique, vous pouvez également demander l'activation de l'identité numérique SPID pour les particuliers.
Vous pouvez consulter tous les types de signature disponibles et leurs coûts respectifs via l'endpoint GET /prodotti. Le code produit requis pour procéder à l'achat sera également disponible dans la réponse.
Pour acheter une signature numérique, localisez d'abord le code de l'appareil qui vous intéresse via l'endpoint GET /prodotti.
Vous pouvez ensuite effectuer une demande POST /richiesta/{codice_prodotto}.
Les paramètres à transmettre dans le corps de la requête sont indiqués dans les exemples de la documentation. Par exemple, pour une demande de clé commerciale InfoCert, les données du demandeur (prénom, nom, courriel, téléphone portable, numéro de sécurité sociale, date et lieu de naissance et adresse de résidence), les données d'expédition et les données d'identification sont requises.
La réponse à la demande POST /richiesta/{codice_prodotto} comprendra toutes les données indiquées, le produit et les options sélectionnés, et surtout l'identifiant de la demande.
Une fois cette demande complétée, il sera nécessaire de télécharger le formulaire via le point de terminaison GET /richiesta/{id}/modulo et de l'envoyer rempli avec le document d'identité. Cette procédure n'est pas nécessaire pour les renouvellements de signature InfoCert.
Il est possible de vérifier le statut de signature d'un document via le point de terminaison GET /firma_elettronica/{id}.
L'envoi des données d'activation et d'utilisation de la signature sera géré différemment par les deux autorités de certification actuelles:
- InfoCert : enverra directement au demandeur le code PIN, le code PUK et le code d'urgence de manière complète et via une enveloppe virtuelle par email.
- Aruba : les 4 premières lettres du code PIN et du code PUK seront disponibles via l'API lorsque la demande sera traitée dans la réponse à la requête GET /richiesta/{id}. La partie restante des codes PIN et PUK sera envoyée directement par Aruba au demandeur.
La signature à distance étrangère InfoCert peut être demandée dans les pays suivants: Autriche, Belgique, République Tchèque, Allemagne, Espagne, France, Croatie, Hongrie, Italie, Pays-Bas, Pologne, Portugal, Roumanie, Saint-Marin, Slovaquie, Slovénie.
Oui, lorsque la demande de dispositif est en statut 'traité', il est possible d'accéder au code de suivi de l'expédition (code_expedition) via l'endpoint GET /richiesta/{id}, ainsi qu'à de nombreuses autres informations.
Oui, c'est possible, mais quiconque utilise la signature électronique dans une iFrame doit nous contacter via le formulaire et demander que le domaine où se trouve l'iFrame soit inscrit sur la whitelist. Cela est nécessaire pour maintenir les normes de sécurité les plus élevées au cours du processus.
L'identification est requise par la réglementation en vigueur selon l'article 32 du décret législatif n° 179 du 26 août 2016. Celle-ci prévoit que le prestataire de services de signature électronique qualifiée délivrant des certificats qualifiés doit s'assurer de l'identification de la personne demandant la certification.
Le formulaire disponible à l'endpoint GET /richiesta/{id}/modulo est le document de demande de délivrance des certificats de signature et est étroitement lié au processus d'identification du demandeur requis par la loi pour la délivrance de la signature.
En effet, l'identification de la personne peut se faire par:
- Signature du formulaire avec authentification par un Officier Public
- Signature numérique du formulaire par le demandeur avec une autre signature valide à son nom
- Reconnaissance vidéo (option achetable)
L'endpoint PATCH /richiesta/{id} peut être utilisé pour envoyer le formulaire signé numériquement, qui n'a pas besoin d'être envoyé également au format papier.
La documentation, en cas d'authentification par un Officier Public, doit être envoyée en original avec une copie de la pièce d'identité du demandeur à l'adresse du fournisseur disponible dans la réponse à la requête effectuée via l'endpoint GET /richiesta/{id}.
La reconnaissance vidéo Aruba ne peut être demandée que pour des signatures achetées depuis le même compte Openapi.
Le service SPID permet de demander l'activation du Personal SPID de 1er et 2ème niveau avec OTP par reconnaissance vidéo. Le service est actif tous les jours, 24 heures sur 24.
La réponse renverra un lien vers la page de la procédure d'identification et de reconnaissance vidéo. Quelques heures, voire quelques minutes, après avoir terminé la procédure, l'utilisateur recevra un courrier électronique confirmant l'activation du SPID.
Vous pouvez demander l'activation du SPID en appelant directement le point de terminaison GET /spid_personale.
Le SPID est valable 2 ans mais ne doit pas être renouvelé par l'utilisateur car, une fois qu'il a expiré, le service est automatiquement renouvelé d'année en année.
Veuillez noter que le SPID est automatiquement révoqué en cas d'inactivité totale pendant un an.
Le coût est de 9,90 euros pour un abonnement et de 14,20 euros pour un appel unique.
Pour toutes les solutions d'abonnement, nous vous invitons à consulter la section Abonnement.
Dans la section Utilisation, au niveau de l'API, vous pouvez suivre vos demandes gratuites et vos demandes d'abonnement ou de recharge. Elles sont disponibles à la fois sous forme de graphique (période, mois et année) et sous forme de résumé textuel.