Signer des documents | Goodflag Docs

curl -X POST https://lp7signbox.example.com/LP7SignBox/signature/sign \
     -H "Content-Type: application/json" \
     -d '{
  "inputDocuments": {
    "inputDocument": [
      {
        "document": {
          "ID": "2",
          "fileName": "text.txt",
          "mimeType": "text/plain",
          "plainData": {
            "plainValue": "dGVzdA=="
          }
        }
      }
    ]
  },
  "parameters": {
    "LP7Signature": {
      "timeStamp": {
        "URLSource": "CLIENT",
        "clientURL": [
          "http://tsa.sunnystamp.com/tsa"
        ]
      },
      "digestAlgorithm": "SHA_256",
      "signedProperties": {
        "signatureType": "APPELLATION",
        "signatureProductionPlace": {
          "city": "Troyes",
          "countryCode": "FR",
          "stateOrProvince": "Aube",
          "postalCode": "10000"
        }
      },
      "advancedSignature": {
        "level": "LONG_TERM_ARCHIVING"
      }
    }
  },
  "signingKey": {
    "keyReference": {
      "reference": "3C5630225A11A11EB3B3A489E0393A283D214EC6",
      "password": "1234"
    }
  },
  "requestID": "sign-2026-09-11-0001"
}'

{
  "result": {
    "resultMajor": 0,
    "resultMinor": 0,
    "resultMessage": "OK"
  },
  "evidenceObject": {
    "document": {
      "ID": "ID2",
      "fileName": "text.txt.p7m",
      "mimeType": "application/clp7",
      "plainData": {
        "plainValue": "MIAGCSqGSIb3DQEHAqCAMIACAQExDzANBglghkgBZQMEAgEFADCABgkqhkiG9w0BBwGggCSABAR0ZXN0AAAAAAAAoIAwggNJMIIC0KADAgECAghIi0ID3cRtUzAKBggqhkjOPQQDAjB0MQswCQYDVQQGEwJGUjEUMBIGA1UECgwLTEVYIFBFUlNPTkExKDAmBgNVBAsMH1N1bm55c3RhbXAgMkQtRG9jIFNlcnZpY2VzIFRlc3QxFjAUBgNVBAsMDTAwMiA0ODA2MjIyNTcxDTALBgNVBAMMBEZSMDAwHhcNMjIwNDIwMDgzNTQ1WhcNMjUwNDIwMDgzNTQ1WjBSMQswCQYDVQQGEwJGUjEbMBkGA1UECgwSTGV4IFBlcnNvbmEgKFRFU1QpMRcwFQYDVQQLDA4wMDAyIDQ4MDYyMjI1NzENMAsGA1UEAwwEVEVTMDBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABKmPDXzNYoCIk77E1DbnnRg0odbgAdcPHEzczZ2eL+Ip9yQFFOjdwMqY0MdEDJzEkoSaD72nP8OS9NoK4H+Ewjw="
      }
    }
  },
  "requestID": "sign-2026-09-11-0001"
}

Signe un ou plusieurs documents avec une clé détenue par le serveur ou fournie sous forme de fichier PKCS#12, selon le profil de signature sélectionné. Retourne le document signé sous forme de preuve (evidence object).

Authentification : TLS mutuel (certificat client).

Requête

This endpoint expects an object.

inputDocumentsobjectRequis

Les contenus à signer.

parametersobjectRequis

Le paramétrage de la signature.

signingKeyobjectRequis

Le paramétrage de la clé de signature.

optionalInputsobjectOptionnel

Les paramètres optionnels du traitement de la requête.

requestIDstringOptionnel

L’identifiant de la requête, choisi par l’appelant. Renvoyé tel quel dans la réponse.

Réponse

L’opération a été traitée. Le résultat est donné par le champ result, renseigné aussi lorsque l’opération a échoué pour une raison métier.

resultobject

Les codes et le message de retour du serveur.

evidenceObjectobjectOptionnel

La preuve (document signé) produite par l’opération.

requestIDstringOptionnel

L’identifiant de la requête, choisi par l’appelant. Renvoyé tel quel dans la réponse.

optionalOutputsobjectOptionnel

Les sorties optionnelles.

Erreurs

400

Bad Request Error