Démarrage et compte
Où puis-je trouver mes clés API live et test, et puis-je les récupérer via l'API ?
Où puis-je trouver mes clés API live et test, et puis-je les récupérer via l'API ?
Existe-t-il un essai gratuit ou un bac à sable ? Combien coûte le mode test ?
Existe-t-il un essai gratuit ou un bac à sable ? Combien coûte le mode test ?
Dois-je signer un contrat ou réserver une démo avant d'utiliser Firma.dev ?
Dois-je signer un contrat ou réserver une démo avant d'utiliser Firma.dev ?
Quelle est la différence entre les rôles Propriétaire, Administrateur et Lecture seule ?
Quelle est la différence entre les rôles Propriétaire, Administrateur et Lecture seule ?
- Propriétaire : seul rôle pouvant gérer la facturation, créer, supprimer ou renommer des espaces de travail, et générer ou régénérer des clés API.
- Propriétaire et Administrateur : peuvent tous deux gérer les webhooks, les domaines personnalisés, les paramètres d’entreprise, les utilisateurs et les demandes de signature. Seul un Propriétaire peut modifier les paramètres stockés sur l’espace de travail, comme la vérification OTP, l’acceptation des conditions et le cadre de signature.
- Lecture seule : peut uniquement lire et copier les données existantes.
Comment ajouter un membre de l'équipe ?
Comment ajouter un membre de l'équipe ?
Pourquoi un nouveau membre de l'équipe n'a-t-il pas reçu d'email d'invitation ?
Pourquoi un nouveau membre de l'équipe n'a-t-il pas reçu d'email d'invitation ?
Comment changer l'email de mon compte, ou fusionner/supprimer un compte ?
Comment changer l'email de mon compte, ou fusionner/supprimer un compte ?
Pourquoi mon lien de réinitialisation de mot de passe est-il expiré, ou pourquoi l'email est-il manquant ?
Pourquoi mon lien de réinitialisation de mot de passe est-il expiré, ou pourquoi l'email est-il manquant ?
Comment fonctionne l'intégration avec Firma.dev ?
Comment fonctionne l'intégration avec Firma.dev ?
Que puis-je faire avec l'API Firma.dev ?
Que puis-je faire avec l'API Firma.dev ?
Comment contacter le support Firma.dev ? Existe-t-il une adresse email de support ?
Comment contacter le support Firma.dev ? Existe-t-il une adresse email de support ?
Tarification et facturation
Que couvre un crédit, et quand est-il facturé ou remboursé ?
Que couvre un crédit, et quand est-il facturé ou remboursé ?
Combien coûte Firma.dev, et existe-t-il des abonnements ou des minimums ?
Combien coûte Firma.dev, et existe-t-il des abonnements ou des minimums ?
Où puis-je télécharger mes factures, et comment ajouter le nom de mon entreprise et mon numéro de TVA ?
Où puis-je télécharger mes factures, et comment ajouter le nom de mon entreprise et mon numéro de TVA ?
Pourquoi l'ajout de crédits échoue-t-il avec une erreur Paddle.js ?
Pourquoi l'ajout de crédits échoue-t-il avec une erreur Paddle.js ?
Comment gérer un volume important, et existe-t-il une recharge automatique ?
Comment gérer un volume important, et existe-t-il une recharge automatique ?
Envoi de demandes de signature
Pourquoi aucun email n'a-t-il été envoyé après la création d'une demande de signature via l'API ?
Pourquoi aucun email n'a-t-il été envoyé après la création d'une demande de signature via l'API ?
POST /signing-requests crée uniquement un brouillon. Il n’envoie jamais d’email de lui-même, quels que soient vos settings.Voir : Envoi d’une demande de signature : Create vs. create-and-sendPuis-je envoyer les liens de signature via mon propre système d'email plutôt que celui de Firma.dev ?
Puis-je envoyer les liens de signature via mon propre système d'email plutôt que celui de Firma.dev ?
settings.send_signing_email: false: supprime l’email de notification de Firma.dev tandis que la demande est quand même envoyée, et cela fonctionne que vous appeliez/sendoucreate-and-send.settings.send_finish_email: false: désactive l’email d’achèvement de la même manière.reminders: tableau que vous fournissez à la création et qui contrôle les emails de rappel, les demandes basées sur un document n’en recevant aucun par défaut et les demandes basées sur un modèle héritant des rappels du modèle sauf si vous les remplacez.
Quelle est l'URL de base correcte de l'API, et pourquoi les chemins documentés renvoient-ils une 404 ?
Quelle est l'URL de base correcte de l'API, et pourquoi les chemins documentés renvoient-ils une 404 ?
.../signing-requests. Les erreurs 404 proviennent souvent de deux sources :https://api.firma.dev/api/v1: un second serveur « Planned » répertorié dans la spécification OpenAPI publique pour une future forme d’API, pas un véritable endpoint, donc un client généré pointé vers celui-ci renvoie une 404 à chaque appel.POST /signing-requests: l’endpoint réel derrière la page de référence « Create Signing Request », et non une route/create-signing-requestcomme le titre pourrait le laisser penser.
À quoi ressemble une charge utile valide pour create-signing-request (destinataires, champs, positions) ?
À quoi ressemble une charge utile valide pour create-signing-request (destinataires, champs, positions) ?
recipients et une liste fields ; chaque champ pointe vers un destinataire et une position sur la page.Chaque destinataire nécessite first_name et email. designation est facultatif et vaut Signer par défaut ; vous pouvez aussi le définir sur Approver ou CC. last_name est obligatoire lors de la création depuis un document ou document_id brut avec POST /signing-requests, et facultatif pour les demandes fondées sur un modèle. order est facultatif.Chaque champ nécessite :type: l’un des types de champs pris en charge, qui incluent égalementradio_buttons,text_area,url,file, etstamp.page_number: la page sur laquelle le champ apparaît.position:x,y,width,heighten pourcentages de la page, pas en pixels.recipient_id: le destinataire auquel appartient le champ.
id temporaire commençant par temp_ (par exemple temp_alice) et définissez recipient_id sur le champ avec la même valeur. L’API le fait correspondre à un véritable UUID et ne renvoie jamais d’ID temporaire.Il n’existe pas de propriété metadata de premier niveau. Utilisez à la place l’objet custom_fields de chaque destinataire.Voir : Sending a signing request: Recipient Schema et Sending a signing request: Field typesQuelle est la taille maximale d'un document, et comment téléverser des fichiers volumineux ?
Quelle est la taille maximale d'un document, et comment téléverser des fichiers volumineux ?
POST /documents: téléverse le fichier et renvoie uneupload_urlprésignée.PUT: envoie le fichier vers cetteupload_url.document_id: transmettez cette valeur lors de la création de la demande de signature.
document sous environ 5 Mo. Un corps de requête supérieur à 6 291 456 octets renvoie 413 REQUEST_TOO_LARGE. Avant le 13 octobre 2026, la passerelle renvoyait 502. Le serveur MCP n’a pas d’outil de téléversement, donc les fichiers volumineux passent par l’API REST.Firma.dev prend-il en charge le DOCX, et pourquoi la conversion DOCX échoue-t-elle parfois ?
Firma.dev prend-il en charge le DOCX, et pourquoi la conversion DOCX échoue-t-elle parfois ?
POST /signing-requests: accepte un fichier DOCX lorsque vous créez directement une demande de signature.POST /documents: accepte un fichier DOCX lorsque vous téléversez un document séparément.
Pourquoi ai-je des demandes de signature en double, et existe-t-il une clé d'idempotence ?
Pourquoi ai-je des demandes de signature en double, et existe-t-il une clé d'idempotence ?
create, create-and-send, send, resend) n’ont pas d’en-tête Idempotency-Key.Un appel create ou create-and-send réessayé automatiquement peut créer une demande de signature en double, facturée séparément et juridiquement contraignante. Rappeler /send sur une demande déjà envoyée renvoie une erreur au lieu de la dupliquer.Pour éviter les doublons, stockez l’id renvoyé par le premier appel et vérifiez sa présence, ou interrogez les demandes existantes, avant de réessayer.Voir : n8n integration: Other common operationsPuis-je modifier l'email d'un destinataire après l'envoi, ou annuler silencieusement ?
Puis-je modifier l'email d'un destinataire après l'envoi, ou annuler silencieusement ?
POST /signing-requests/{id}/cancel: l’endpoint à appeler pour annuler une demande.notify_signers: false: un paramètre de cet appel d’annulation lui-même, et non un paramètre défini à la création, qui supprime la notification au signataire.settings.send_cancellation_emailsur la demande de signature, activé par défaut, doit également être vrai pour qu’un email d’annulation soit envoyé.
Une demande de signature peut-elle inclure plusieurs documents, ou remplacer le document d'un modèle ?
Une demande de signature peut-elle inclure plusieurs documents, ou remplacer le document d'un modèle ?
POST /documents, puis envoyez les identifiants dans l’ordre des documents sous document_ids sur POST /templates, POST /signing-requests ou POST /signing-requests/create-and-send. Envoyez exactement une source de document : document, document_id, document_ids ou template_id.Utilisez les routes /documents sur un modèle ou une demande de signature à l’état de brouillon pour ajouter, remplacer, renommer, réordonner et supprimer chaque document ; une fois qu’une demande de signature est envoyée, terminée, annulée ou refusée, ces modifications renvoient 409 DOCUMENT_SET_LOCKED. Téléchargez chaque document d’une demande de signature avec GET /signing-requests/{id}/documents/{document_id}/download, tel que téléversé ou scellé individuellement.Pour remplacer un document et conserver ses champs, utilisez PATCH .../documents/{document_id} avec un nouveau fichier téléversé ayant le même nombre de pages et les mêmes dimensions de page (à 1 pt près) ; sur une demande de signature, un document placé avec des balises d’ancrage n’est remplacé que si les ancrages du nouveau fichier se résolvent exactement comme ils sont enregistrés. Consultez le journal des modifications de l’API v1.39.0.Comment télécharger le PDF signé et le certificat via l'API ?
Comment télécharger le PDF signé et le certificat via l'API ?
GET /signing-requests/{id}/download renvoie le PDF signé sous forme d’URL présignée.Il renvoie une unique download_url présignée de courte durée, valide jusqu’à l’horodatage expires_at : le PDF final pour une demande terminée, ou un instantané de progression partielle pour une demande envoyée qui n’est pas terminée. Pour une demande terminée, ce PDF unique comporte déjà le certificat d’achèvement et les pages de piste d’audit ajoutées au document signé, et cet endpoint ne fournit pas d’URL distincte pour le seul certificat. Pour obtenir des fichiers séparés lorsqu’ils existent, lisez document_only_download_url et certificate_only_download_url dans GET /signing-requests/{id}.Appeler cet endpoint se comporte différemment selon l’état de la demande de signature :409: renvoyé si vous l’appelez avant que la demande n’ait été envoyée, ou pour une demande terminée tant que son certificat d’achèvement est encore en cours de génération.- Pour une demande envoyée qui n’est pas terminée (en cours, expirée, annulée ou refusée) : renvoie un instantané de progression partielle des signataires qui ont terminé jusque-là. Aucun paramètre ne permet de l’activer.
503: renvoyé avec un en-têteRetry-Aftertant qu’un instantané de progression partielle est encore en cours de génération.
Puis-je récupérer l'image de signature d'un signataire ou ses fichiers téléversés via l'API ?
Puis-je récupérer l'image de signature d'un signataire ou ses fichiers téléversés via l'API ?
GET /signing-requests/{id}/signers/{signer_id}/signature: renvoie la signature adoptée sous forme d’URI de donnéesdata:image/png;base64,....GET /signing-requests/{id}/signers/{signer_id}/initials: renvoie les initiales adoptées de la même manière.GET /signing-requests/{id}/signers/{signer_id}/stamps/{field_id}: renvoie une image de tampon pour lefield_iddonné, les tampons étant propres à chaque champ.GET /signing-requests/{id}/signers/{signer_id}/files/{field_id}: renvoie une URL de téléchargement présignée, valide 300 secondes, pour un fichier téléversé dans un champ de typefile, et non les octets du fichier directement.GET /signing-requests/{id}/fields: filtrez surtype=filepour trouver lefield_idd’un fichier téléversé.
Comment relire les valeurs des champs par nom de variable après la signature ?
Comment relire les valeurs des champs par nom de variable après la signature ?
GET /signing-requests/{id}/fields renvoie tous les champs de la demande ; lisez la propriété value de chaque entrée pour obtenir la valeur résolue, et faites correspondre sur variable_name.Voir : Field Prefilling: Reading field values backModèles / champs / balises d’ancrage
Comment sont interprétés les x/y/width/height d'un champ ?
Comment sont interprétés les x/y/width/height d'un champ ?
x, y, width, et height sont des pourcentages de la page, pas des pixels. L’origine est le coin supérieur gauche et y augmente vers le bas.Un champ spécifié manuellement renvoie une erreur 400 lorsque x+width>100 ou y+height>100. Les champs placés par des balises d’ancrage sont en revanche ramenés automatiquement dans les limites de la page.Comment fonctionnent les balises d'ancrage, et quels types de champs prennent-elles en charge ?
Comment fonctionnent les balises d'ancrage, et quels types de champs prennent-elles en charge ?
anchor_tags sur une requête de création basée sur un document, jusqu’à 100 balises par requête.Les balises d’ancrage acceptent tous les types de champs, ainsi que dropdown_options, format_rules, multi_group_id, et conditions.Pourquoi le texte d'ancrage n'est-il pas supprimé, ou pourquoi le champ semble-t-il décalé ?
Pourquoi le texte d'ancrage n'est-il pas supprimé, ou pourquoi le champ semble-t-il décalé ?
remove_anchor_text rend le texte correspondant invisible dans le flux de contenu du PDF plutôt que de le supprimer.Cela peut échouer sur des polices intégrées/sous-ensemble (CID) ou lorsque le texte marqueur est réparti sur plusieurs opérateurs d’affichage de texte PDF distincts. Lorsque cela se produit, le système dessine automatiquement une boîte blanche uniquement sur la zone du marqueur correspondant, même sans que add_white_background soit défini.Que signifie « no glyph advances for font » ?
Que signifie « no glyph advances for font » ?
opacity CSS inférieure à 1, ou un transform, à l’intérieur d’un Form XObject de groupe de transparence.L’extracteur rejoue le texte à l’intérieur des contextes de formulaire et de groupe (à l’exclusion des flux d’apparence d’annotation), si bien que les ancres qui s’y trouvent sont détectées.Si cela se reproduit, l’ancre se trouve probablement dans une construction de police/géométrie malformée ou inhabituelle. Réexportez le PDF source avec un encodage de police standard.Comment préremplir des champs, et le signataire peut-il quand même modifier la valeur ?
Comment préremplir des champs, et le signataire peut-il quand même modifier la valeur ?
format_rules.prefilledData sur un champ pour le remplir automatiquement et le verrouiller à partir des données du destinataire.Le signataire peut quand même modifier la valeur si vous définissez également format_rules.prefilledEditable sur true.Cela fonctionne de la même manière sur les champs placés par des balises d’ancrage, puisque les balises d’ancrage acceptent elles aussi format_rules.Pourquoi le texte d'un champ rétrécit-il ou est-il coupé, et puis-je définir une taille de police ?
Pourquoi le texte d'un champ rétrécit-il ou est-il coupé, et puis-je définir une taille de police ?
format_rules.fontSize pour une taille de départ explicite. Si le texte est encore coupé, agrandissez le champ ou passez à un textarea.Comment créer des groupes de cases à cocher à sélection unique, et pourquoi les valeurs des boutons radio/cases à cocher s'affichent-elles en true/false ?
Comment créer des groupes de cases à cocher à sélection unique, et pourquoi les valeurs des boutons radio/cases à cocher s'affichent-elles en true/false ?
multi_group_id à un ensemble de champs pour les relier en un groupe.radio_buttons: les champs partageant unmulti_group_idforment un groupe mutuellement exclusif.checkbox: les champs partageant unmulti_group_idforment un groupe indépendant.
"true".Un champ checkbox s’affiche comme une case à cocher native, et non comme une icône de coche personnalisée.Comment fonctionnent les règles conditionnelles de visibilité/caractère obligatoire via l'API, et pourquoi n'ont-elles pas été appliquées ?
Comment fonctionnent les règles conditionnelles de visibilité/caractère obligatoire via l'API, et pourquoi n'ont-elles pas été appliquées ?
visibility_conditions et required_conditions sont des objets ConditionSet sur un champ qui référencent le field_id d’un autre champ du même destinataire.GET /templates/{id}/fields: renvoie les deux propriétés, même si le schéma OpenAPI public les omet.
/duplicate), les deux jeux de conditions sont copiés et leurs références field_id sont remappées.Comment ajouter des initiales sur chaque page, ou plusieurs champs de signature pour un même signataire ?
Comment ajouter des initiales sur chaque page, ou plusieurs champs de signature pour un même signataire ?
initial par page dans le tableau fields, chacun avec son propre page_number. Un même destinataire peut avoir plusieurs champs obligatoires du même type, y compris plusieurs champs signature.Comment remplir automatiquement la date de signature, et quel fuseau horaire est utilisé ?
Comment remplir automatiquement la date de signature, et quel fuseau horaire est utilisé ?
date pour remplir automatiquement la date de signature.Le champ s’affiche en lecture seule dans la vue de signature et se remplit avec la date locale du navigateur du signataire au moment où il termine, et non avec un fuseau horaire serveur.date_signing_default: true: active le remplissage automatique ; il n’existe pas de typedate_signeddistinct.timezone: le paramètre de l’espace de travail vérifié en premier pour les horodatages du certificat, avec UTC par défaut tant que vous ne le définissez pas.default_timezone: le repli au niveau de l’entreprise vérifié ensuite, également avec UTC par défaut tant que vous ne le définissez pas.
Les modèles sont-ils partagés entre les espaces de travail, et comment en copier un ?
Les modèles sont-ils partagés entre les espaces de travail, et comment en copier un ?
POST /templates/{id}/copy: copie en profondeur les champs, les destinataires, la liste CC, les rappels, les définitions de champs personnalisés et le document du modèle vers un autre espace de travail, à l’aide d’une clé API de niveau entreprise (protégée).workspace_id: l’espace de travail cible que vous transmettez dans le corps de la requête.POST /templates/{id}/duplicate: crée à la place une nouvelle demande de signature à partir du modèle, pas une copie du modèle.
Expérience de signature
Puis-je rediriger le signataire ou personnaliser la page d'achèvement après la signature ?
Puis-je rediriger le signataire ou personnaliser la page d'achèvement après la signature ?
completion_redirect_url: redirige le signataire une fois qu’il a terminé de signer.completion_title: personnalise le titre de la page d’achèvement, défini aux côtés de l’URL de redirection.completion_message: personnalise le message de la page d’achèvement, défini aux côtés de l’URL de redirection.signing.completed: l’événement à écouter à la place, si vous intégrez la vue de signature.
Puis-je renommer ou masquer les boutons de signature, ou masquer le sélecteur de langue ?
Puis-je renommer ou masquer les boutons de signature, ou masquer le sélecteur de langue ?
signing_button_label_overrides, en utilisant des clés de traduction comme common.finish, signing.approveAndFinish, signing.nextRequiredField, signing.saveAndFinishLater et signing.decline.confirm. Depuis v1.40.0, définissez allow_decline ou show_save_for_later sur false pour masquer Refuser de signer ou Enregistrer et terminer plus tard. Le sélecteur de langue reste toujours affiché.disable_guided_navigation désactive le défilement automatique vers le champ suivant, affiché dans le tableau de bord sous le nom « Désactiver le défilement automatique ».Voir : Paramètres de l’espace de travailPuis-je désactiver ou personnaliser l'étape d'acceptation des conditions ?
Puis-je désactiver ou personnaliser l'étape d'acceptation des conditions ?
Les signataires peuvent-ils corriger leur nom ou leur entreprise avant de signer sur des liens transférés ?
Les signataires peuvent-ils corriger leur nom ou leur entreprise avant de signer sur des liens transférés ?
identity_editable_fields sur la demande de signature ou le modèle, par exemple name et company, pour que le signataire puisse modifier ses propres informations avant de signer. Une boîte de dialogue de correction apparaît juste après qu’il accepte les conditions, et chaque modification est écrite dans la piste d’audit.Voir : Scénarios de demandes de signature - Schéma : Deuxième signataire dynamiqueComment les signataires peuvent-ils signer, puis-je imposer des signatures manuscrites, et le cyrillique est-il pris en charge ?
Comment les signataires peuvent-ils signer, puis-je imposer des signatures manuscrites, et le cyrillique est-il pris en charge ?
hand_drawn_only sur true sur la demande de signature ou le modèle pour retirer l’onglet Saisir et imposer le dessin.Firma.dev ne prend pas en charge les certificats X.509 fournis par le signataire ; il applique son propre sceau PAdES au document complété côté serveur.Voir : Scénarios de demandes de signatureLa page de signature est vierge ou noire. Que doit essayer le signataire ?
La page de signature est vierge ou noire. Que doit essayer le signataire ?
Puis-je définir le zoom initial de la page de signature ?
Puis-je définir le zoom initial de la page de signature ?
?zoom= à l’URL de signature.Voir : Signature intégrable - Paramètres d’URLPourquoi un lien de signature indique-t-il qu'il est invalide, expiré, ou déjà signé ?
Pourquoi un lien de signature indique-t-il qu'il est invalide, expiré, ou déjà signé ?
- Not sent yet: ouvrir le lien avant que l’expéditeur n’ait réellement envoyé la demande affiche ce message.
- Expired: la fenêtre
expiration_hoursde la demande, mesurée à partir du moment de l’envoi, est dépassée ; comme une demande envoyée ne peut plus être modifiée, l’expéditeur doit créer une nouvelle demande plutôt que d’en prolonger l’expiration. - Already signed: ce destinataire précis a terminé sa signature ; cela est propre à son propre lien unique, donc cela ne se produit pas si un autre signataire ouvre son propre lien.
- Invalid: un lien cassé ou mal saisi, ou un lien correspondant à une demande annulée, produit sa propre erreur distincte plutôt que « already signed ».
L'un des deux signataires peut-il signer indifféremment, ou mon entreprise peut-elle signer automatiquement sa propre partie ?
L'un des deux signataires peut-il signer indifféremment, ou mon entreprise peut-elle signer automatiquement sa propre partie ?
Que se passe-t-il si deux signataires partagent le même email, ou si un lien de signature est transféré ?
Que se passe-t-il si deux signataires partagent le même email, ou si un lien de signature est transféré ?
identity_editable_fields permet au signataire réel de corriger sa propre identité avant de signer, et cette correction est enregistrée dans la piste d’audit.Voir : Scénarios de demandes de signature - Scénario : Deuxième signataire dynamiqueComment activer la signature par code QR sur téléphone ?
Comment activer la signature par code QR sur téléphone ?
{{signing_qr_code}} aux modèles d’invitation pour l’inclure dans les emails.Voir : Paramètres de l’espace de travail : Code QR dans les emailsVérification d’identité (OTP)
Combien de temps un code OTP est-il valide, et pourquoi ne m'est-il pas redemandé quand je rouvre le lien de signature ?
Combien de temps un code OTP est-il valide, et pourquoi ne m'est-il pas redemandé quand je rouvre le lien de signature ?
Le certificat de finalisation indique-t-il qu'un signataire a utilisé le code à usage unique ?
Le certificat de finalisation indique-t-il qu'un signataire a utilisé le code à usage unique ?
Puis-je définir la langue de l'email ou de l'OTP d'une demande de signature, ou personnaliser l'email OTP ?
Puis-je définir la langue de l'email ou de l'OTP d'une demande de signature, ou personnaliser l'email OTP ?
language sur la demande de signature elle-même pour remplacer les valeurs par défaut de l’espace de travail et de l’entreprise pour les emails destinés au signataire de cette demande, email OTP compris. Les modèles d’email personnalisés ne peuvent pas modifier le texte de l’email OTP, mais vous pouvez ignorer l’OTP entièrement pour une demande en définissant settings.require_otp_verification sur false.Voir : Localisation, Marque blancheFirma.dev prend-il en charge l'OTP par SMS ou les eID nationaux (BankID, MitID, FranceConnect) ?
Firma.dev prend-il en charge l'OTP par SMS ou les eID nationaux (BankID, MitID, FranceConnect) ?
Webhooks
Les webhooks affichent le statut activé sans aucun échec, mais rien n'est livré. Pourquoi ?
Les webhooks affichent le statut activé sans aucun échec, mais rien n'est livré. Pourquoi ?
PATCH /workspaces/{id}: définissezwebhook_enabledsurtruedans le corps de la requête pour activer les webhooks sans passer par le tableau de bord.ignore_company_webhooks: assurez-vous que ce paramètre n’est pastruesur l’espace de travail ; il exclut silencieusement l’espace de travail des webhooks de l’entreprise.
Quelle est la différence entre les webhooks au niveau de l'entreprise et de l'espace de travail pour les secrets, l'exclusion, et l'événement de consultation ?
Quelle est la différence entre les webhooks au niveau de l'entreprise et de l'espace de travail pour les secrets, l'exclusion, et l'événement de consultation ?
- Secrets: les webhooks au niveau de l’entreprise et de l’espace de travail ont chacun leur propre secret de signature.
ignore_company_webhooks: permet à un espace de travail de s’exclure entièrement des webhooks de son entreprise, sans affecter les autres espaces de travail.signing_request.viewed: se déclenche uniquement lors de la première consultation d’un destinataire, pas à chaque ouverture ultérieure.
Pourquoi les livraisons de webhook échouent-elles avec une erreur de redirection ?
Pourquoi les livraisons de webhook échouent-elles avec une erreur de redirection ?
www, le chemin, ou une barre oblique finale manquante ou en trop fait échouer chaque tentative de livraison.Voir : Webhooks - DépannageQuelle est la politique de nouvelle tentative des webhooks, le délai d'expiration, et le seuil de désactivation automatique ? Puis-je renvoyer des événements passés ?
Quelle est la politique de nouvelle tentative des webhooks, le délai d'expiration, et le seuil de désactivation automatique ? Puis-je renvoyer des événements passés ?
Dois-je effectuer du polling sur GET /signing-requests/{id} pour le statut plutôt que d'utiliser les webhooks ?
Dois-je effectuer du polling sur GET /signing-requests/{id} pour le statut plutôt que d'utiliser les webhooks ?
GET /signing-requests/{id}: n’effectuez pas de polling sur ce point de terminaison pour le statut ; les webhooks poussent les mises à jour à la place.
Livraison des emails et modèles
Que signifie l'erreur RECIPIENT_EMAIL_SUPPRESSED (422), et comment débloquer une adresse ?
Que signifie l'erreur RECIPIENT_EMAIL_SUPPRESSED (422), et comment débloquer une adresse ?
RECIPIENT_EMAIL_SUPPRESSED (HTTP 422) signifie que le destinataire figure sur la liste de suppression de Firma.dev ; contactez le support pour débloquer une adresse.Voir : Délivrabilité des E-mails : L’erreur RECIPIENT_EMAIL_SUPPRESSED, Délivrabilité des E-mails : Demander la levée de suppressionPuis-je personnaliser le nom et l'adresse de l'expéditeur des invitations à signer ?
Puis-je personnaliser le nom et l'adresse de l'expéditeur des invitations à signer ?
email_local_part au niveau de l’entreprise ou de l’espace de travail.Voir : Adresse d’expéditeur personnaliséeComment désactiver l'email de finalisation, omettre le certificat, ou gérer les pièces jointes des destinataires en copie ?
Comment désactiver l'email de finalisation, omettre le certificat, ou gérer les pièces jointes des destinataires en copie ?
settings de la demande de signature :send_finish_email: false: arrête l’email de finalisation.attach_pdf_on_finish: false: envoie un lien de téléchargement au lieu de joindre le PDF.document_only_download_url: partage le document sans le certificat, au lieu definal_document_download_url.certificate_only_download_url: renvoie uniquement le certificat.allow_download: false: désactive entièrement les liens de téléchargement, indépendamment deattach_pdf_on_finish.
Quels placeholders les modèles d'email prennent-ils en charge, et puis-je les personnaliser par langue ?
Quels placeholders les modèles d'email prennent-ils en charge, et puis-je les personnaliser par langue ?
{{placeholder}}.L’ancienne syntaxe [bracket] fonctionne aussi et ne fait pas de distinction de casse ; un placeholder non résolu s’affiche comme vide, pas comme du texte brut.{{team_name}}: un alias de{{workspace_name}}.{{team_email}}: un alias de{{workspace_email}}.{{download_link}}: ne se résout que dans les emails de finalisation.
Puis-je contrôler le fuseau horaire ou le format de date affiché dans les emails ?
Puis-je contrôler le fuseau horaire ou le format de date affiché dans les emails ?
timezone: un fuseau horaire IANA défini sur l’espace de travail via l’API des paramètres.default_timezone: le repli au niveau de l’entreprise lorsque le fuseau horaire de l’espace de travail n’est pas défini.
{{expiration_date}} dans les emails de signature utilisent ce fuseau horaire et la langue de l’email. L’UTC reste la valeur par défaut lorsqu’aucun des deux n’est défini.Voir : Fuseaux horaires pris en chargePourquoi les emails aux signataires sont-ils en anglais alors que mon espace de travail est configuré dans une autre langue ?
Pourquoi les emails aux signataires sont-ils en anglais alors que mon espace de travail est configuré dans une autre langue ?
en par défaut tant que vous ne définissez pas language explicitement. Définissez-le sur l’espace de travail, ou transmettez language dans la demande, et les nouveaux emails aux signataires l’utiliseront.Voir : Paramètres de langue des emailsDomaines d’envoi personnalisés
De quels enregistrements DNS ai-je besoin, et quel est le flux de vérification du domaine ?
De quels enregistrements DNS ai-je besoin, et quel est le flux de vérification du domaine ?
Que signifie « Conflit de domaine », ou un statut « en cours de finalisation » qui reste bloqué ?
Que signifie « Conflit de domaine », ou un statut « en cours de finalisation » qui reste bloqué ?
sign.yourcompany.com, qui se vérifie indépendamment. Supprimer le domaine de Firma.dev libère le propre enregistrement de Firma.dev pour une réutilisation ailleurs, mais n’a aucun effet sur un enregistrement dans le compte Resend de quelqu’un d’autre.Voir : Domaines personnalisés - Vous utilisez déjà Resend pour votre propre messagerie ?Pourquoi le statut du domaine reste-t-il en attente ou non vérifié alors que le DNS est correct ?
Pourquoi le statut du domaine reste-t-il en attente ou non vérifié alors que le DNS est correct ?
verify-dns ; il vérifie en direct à chaque fois, donc un incident transitoire peut signaler le domaine comme non vérifié même lorsque le DNS est correct.Voir : Domaines personnalisés - États de vérification, Domaines personnalisés - Bizarrerie d’affichage connuePourquoi mon domaine vérifié a-t-il cessé de fonctionner, et les emails sont-ils repassés à l'adresse de Firma.dev ?
Pourquoi mon domaine vérifié a-t-il cessé de fonctionner, et les emails sont-ils repassés à l'adresse de Firma.dev ?
Puis-je utiliser le même domaine d'envoi dans plusieurs espaces de travail ?
Puis-je utiliser le même domaine d'envoi dans plusieurs espaces de travail ?
Validité juridique / certificats / sécurité
Quel niveau de signature Firma.dev fournit-il, et est-il juridiquement valide au regard d'eIDAS/ESIGN ?
Quel niveau de signature Firma.dev fournit-il, et est-il juridiquement valide au regard d'eIDAS/ESIGN ?
PAdES-B-LTA (Baseline Long-Term Archival), émis depuis la propre autorité de certification de Firma.dev, avec un horodatage RFC 3161 intégré.Voir : Validité Juridique et Conformité eIDAS - Ce que fournit Firma.devPourquoi Adobe Acrobat ou le validateur DSS de l'UE affichent-ils ma signature comme non fiable ?
Pourquoi Adobe Acrobat ou le validateur DSS de l'UE affichent-ils ma signature comme non fiable ?
Où mes données sont-elles stockées, et Firma.dev est-il certifié SOC 2 / ISO ?
Où mes données sont-elles stockées, et Firma.dev est-il certifié SOC 2 / ISO ?
Comment supprimer des demandes de signature ou des documents, par exemple pour une demande RGPD ?
Comment supprimer des demandes de signature ou des documents, par exemple pour une demande RGPD ?
Dans quelle langue le certificat de complétion est-il généré, et peut-il afficher mon logo ?
Dans quelle langue le certificat de complétion est-il généré, et peut-il afficher mon logo ?
Les horodatages d'archivage sont-ils renouvelés dans le temps, et que se passe-t-il si une signature est contestée ?
Les horodatages d'archivage sont-ils renouvelés dans le temps, et que se passe-t-il si une signature est contestée ?
PAdES-B-LTA une seule fois, au moment de la signature. Le profil LTA intègre dans le PDF lui-même la chaîne de certificats complète, un horodatage de confiance et les données de révocation : la signature emporte donc tout ce dont un vérificateur a besoin et reste auto-validable sur le long terme, sans nouvel horodatage de votre part. Si une signature est contestée, les responsabilités liées à l’identité du signataire, au consentement et à la conservation des enregistrements sont énoncées dans les Conditions Générales d’Utilisation de Firma.dev.Voir : Validité Juridique : Ce que fournit Firma.dev, Piste d’AuditPuis-je supprimer l'en-tête Signing Request ID du PDF signé ?
Puis-je supprimer l'en-tête Signing Request ID du PDF signé ?
Signing Request ID: <id> est dessiné sur chaque page du PDF signé et du certificat de complétion, en petit texte gris près de la marge supérieure ; il n’existe aucun paramètre d’espace de travail ou d’API pour le désactiver.L’en-tête est dessiné avec une police intégrée, de sorte que les documents scellés passent la validation PDF/A-2b.Firma.dev convient-il à une utilisation en France : eIDAS, RGPD et HDS ?
Firma.dev convient-il à une utilisation en France : eIDAS, RGPD et HDS ?
PAdES-B-LTA. Au titre du RGPD, Firma.dev agit comme sous-traitant ; l’accord de traitement des données est publié et s’applique à tous les clients, incorporé aux Conditions Générales par référence.Voir : Sécurité, Validité juridique et conformité eIDASEspaces de travail et multi-tenant
Chaque client devrait-il avoir son propre espace de travail ? Y a-t-il une limite ?
Chaque client devrait-il avoir son propre espace de travail ? Y a-t-il une limite ?
Qu'est-ce que l'espace de travail protégé/par défaut, et pourquoi ai-je une erreur 403 PROTECTED_WORKSPACE ?
Qu'est-ce que l'espace de travail protégé/par défaut, et pourquoi ai-je une erreur 403 PROTECTED_WORKSPACE ?
protected.Il est destiné à être géré depuis le tableau de bord plutôt que via l’API ; appeler un point de terminaison de gestion sur celui-ci avec une clé API standard renvoie un 403 avec le code PROTECTED_WORKSPACE.Pour les paramètres à l’échelle du compte, utilisez :default_timezone et language, entre autres champs. Pour tout ce que vous devez gérer directement via l’API, créez plutôt des espaces de travail séparés, non protégés.Voir : Espaces de travail : cas particuliers et dépannage, Paramètres de l’espace de travail : mettre à jour les paramètres de l’espace de travailMarque blanche et intégration
Quelles parties de Firma.dev puis-je mettre en marque blanche, et puis-je utiliser mon propre domaine d'API ?
Quelles parties de Firma.dev puis-je mettre en marque blanche, et puis-je utiliser mon propre domaine d'API ?
api.firma.dev lui-même ne peut pas être proxifié sous votre propre domaine ; seul le domaine d’envoi d’email est personnalisable. Le certificat de complétion peut également être mis en marque blanche, votre logo remplaçant celui de Firma.dev. show_custom_branding_only retire uniquement la ligne de contact du support Firma.dev des emails ; cela ne retire pas la présence de Firma.dev de la page de signature elle-même.Comment définir les couleurs de marque et un logo par espace de travail via l'API ?
Comment définir les couleurs de marque et un logo par espace de travail via l'API ?
Pourquoi l'éditeur de modèles intégré rogne-t-il le zoom/le panoramique, et qu'en est-il des PDF qui échouent à se charger après un moment ?
Pourquoi l'éditeur de modèles intégré rogne-t-il le zoom/le panoramique, et qu'en est-il des PDF qui échouent à se charger après un moment ?
initialZoom pour contrôler directement le zoom initial de l’éditeur de modèles intégré.autoFit (booléen) est l’alternative ; initialZoom (nombre) est prioritaire lorsque les deux sont définis. Chaque canevas de document prend en charge le panoramique via un glissement au bouton central de la souris, laissant le clic gauche libre pour l’interaction avec les champs.Les URL de documents signés expirent après 1 heure. L’éditeur de modèles intégré demande automatiquement une nouvelle URL et retente jusqu’à 3 fois au lieu d’échouer.Si les téléchargements sont bloqués, vérifiez la présence d’un attribut sandbox sur votre propre page ; les exemples d’intégration de Firma.dev n’en définissent aucun.Voir : Éditeur de modèles intégrablePuis-je injecter du CSS personnalisé dans les intégrations, ou intégrer seulement la zone de signature ?
Puis-je injecter du CSS personnalisé dans les intégrations, ou intégrer seulement la zone de signature ?
Outils / SDK / limites
Comment me connecter aux serveurs MCP de Firma.dev, et lequel dois-je utiliser ?
Comment me connecter aux serveurs MCP de Firma.dev, et lequel dois-je utiliser ?
Quels SDK Firma.dev propose-t-il ? Existe-t-il un SDK Python ?
Quels SDK Firma.dev propose-t-il ? Existe-t-il un SDK Python ?
@firma-dev/sdk, généré à partir de la même spécification OpenAPI que la référence de l’API :requests.Voir : SDK TypeScript pour l’API Firma.dev - InstallationQuelles sont les limites de débit de l'API ?
Quelles sont les limites de débit de l'API ?
Pourquoi vois-je « FunctionsFetchError: Failed to send a request to the Edge Function » dans la console ?
Pourquoi vois-je « FunctionsFetchError: Failed to send a request to the Edge Function » dans la console ?
Pour les signataires (vous avez reçu un document)
Où puis-je obtenir une copie d'un document après l'avoir signé ?
Où puis-je obtenir une copie d'un document après l'avoir signé ?
J'ai une question sur un document, je veux annuler ma signature, ou mon lien a expiré. Que dois-je faire ?
J'ai une question sur un document, je veux annuler ma signature, ou mon lien a expiré. Que dois-je faire ?
- Ouvrez Utilisateurs dans la barre latérale et cliquez sur Ajouter un Utilisateur.
- Saisissez son nom et son adresse email, puis choisissez un Niveau de Compte : Administrateur ou Lecture Seule (seul un Propriétaire peut ajouter un autre Propriétaire). La question précédente sur les rôles explique ce que chaque niveau permet.
- Cliquez sur Envoyer l’Invitation.
Si l’adresse email n’a pas encore de compte Firma.dev, le compte est créé immédiatement et un mot de passe temporaire s’affiche une seule fois à l’écran. Aucun email d’invitation n’est envoyé : communiquez ce mot de passe à la personne (voir la question suivante). Si la personne a déjà un compte Firma.dev, elle est ajoutée à votre entreprise immédiatement et conserve son mot de passe actuel.