JSON object:

"signProperties": {
    "orderName": "My order name",
    "documentDisplayMode": "interior",
    "showConfirmation": true,
    "showUnderstanding": true,
    "timeoutSeconds": 1800
}

JSON array of documents to be signed (minimum one).

The document to be signed is represented as a JSON object:

*Each document must provide a value for either "text", "pdf" or the pair "xml" and "xsl".

"documents": [
{
    "description": "My PDF document",
    "pdf": "JVBER..."
},
{
    "description": "My text",
    "text": "My text to sign...",
},
{
    "xml": "<?xml version=\"1.0\" encoding=\"ISO-8859-1\" ?> ...",
    "xls": "<?xml version=\"1.0\" encoding=\"ISO-8859-1\" ?><xsl:stylesheet ..."
}
]

JSON array of string.

The string values will determine the content result when retrieving a completed sign order:

• "basicSignature": Result contains the end user and merchant signatures (in ISO-8859 text format)
• "documentHash": Result contains the SHA256 hash over the documents to be signed (in UTF-8 text format).
• "sdo": Result contains the documents and signature data in the SEID-SDO format.

["basicSignature", "documentHash", "sdo"]

{
    "sign_id": "2a8d69ba-2607-9a1e-9e60-bdb6cc67eacf",
}

An order must have a name - Please provide reference: GHIjKl if reporting the problem.

403 Forbidden

AccessToken is invalid - Please provide reference: GHIjKl if reporting the problem.

POST [signdoc-base-url]/signdoc

Request body:

{
    "signProperties": {
    "orderName": "My order name",
    "documentDisplayMode": "interior",
    "showConfirmation": true,
    "showUnderstanding": true
    },
    "documents": [
        {
            "text": "My text to sign"
        },
        {
            "description": "My PDF order",
            "pdf": "JVBER..."
        }
    ],
    "resultContent": [
        "sdo",
        "basicSignature",
        "documentHash"
    ]
}

Sign order was found.
Returns signing results, sign_id, order state and order name.

If order is not completed, i.e. order state is not "SIGN_COMPLETED", the signing results will be an empty array.

The content of the signing results depends on the values pass to the resultContent array when creating the order:

• "basicSignature": Result contains the end user and merchant signatures (in ISO-8859 text format)
• "merchantSignatures":
  • Array of merchant signatures in ISO-8859 text format for each document in the same order they were provided when creating the sign order.
  • Set by "basicSignature" in resultContent when creating order.
• "endUserSignatures":
  • Array of end user signatures in ISO-8859 text format for each document in the same order they were provided when creating the sign order.
  • Set by "basicSignature" in resultContent when creating order.
• "sdos":
  
  • Array of base64 encoded SEID-SDOs (unpack to UTF-8) in the same order they were provided when creating the sign order.
  • Set by "sdo" in resultContent when creating order.
• documentHashes":
  
  • Array of SHA256 hash over the documents to be signed (in UTF-8 text format) in the same order they were provided when creating the sign order.
  • Set by "documentHash" in resultContent when creating order.

{
    "documentHashes": [
        "5OKv0...",
        "l5hoT...",
        "PyLlx..."
    ],
    "merchantSignatures": [
        "MIAGC...",
        "MIAGC...",
        "MIAGC..."
    ],
    "sdos": [
        "PD94b...",
        "PD94b...",
        "PD94b...",
    ],
    "endUserSignatures": [
        "MIAGC...",
        "MIAGC...",
        "MIAGC..."
    ],
    "clientId": "my-oidc-client-id",
    "signId": "2a8d69ba-2607-9a1e-9e60-bdb6cc67eacf",
    "orderState": "SIGN_COMPLETED",
    "orderName": "My order name"
}

Sign order was not found.

This could be caused by timeout or an invalid sign_id.

signId should not be empty - Please provide reference: GHIjKl if reporting the problem.

403 Forbidden

{
    "signProperties": {
        "orderName": "test order",
        "showUnderstanding": "true",
        "showConfirmation": "false",
        "documentDisplayMode": "overlay"
    },
    "resultContent": [
        "sdo"
    ],
    "documents": [
        {
            "description": "my first document to sign",
            "text": "Testing å and ø...."
        },
        {
            "text": "Short version of a document having two linefeeds\n\ndescription when listet in BankID WebClient should be 'test order - 2"
        },
        {
            "description": "An xslt transformation",
            "xml": "<?xml version=\"1.0\" encoding=\"ISO-8859-1\" ?><Persons><Person><Name>Ola Normann</Name><Street>Olaveien 99</Street><Zip>0014</Zip><City>Oslo</City></Person><Person><Name>Kalle</Name><Street>Ibsens veg 30</Street><Zip>9876</Zip><City>Stockholm</City></Person><Person><Name>Kari IngridsDottir</Name><Street>Nedre Sofustrøa 2</Street><Zip>7070</Zip><City>Bosberg</City></Person><Person><Name>Olava Olsen</Name><Street>Øvre Strete 12</Street><Zip>2211</Zip><City>Sørpå</City></Person></Persons>",
            "xsl": "<?xml version=\"1.0\" encoding=\"ISO-8859-1\" ?><xsl:stylesheet version=\"1.0\" xmlns:xsl=\"http://www.w3.org/1999/XSL/Transform\"> xsl:output method=\"html\" encoding=\"ISO-8859-1\" doctype-system=\"http://www.w3.org/TR/html4/loose.dtd\" doctype-public=\"-//W3C//DTD HTML 4.01 Transitional//EN\" indent=\"yes\" /><xsl:template match=\"/\"><HTML><BODY><h2>Eksempel på XML/XSL.</h2><p>Under er en liste personer tatt fra XML-en</p><ul><xsl:for-each select=\"Persons/Person\"><xsl:if test=\"0 = position() mod 2\"><li style='color:red'><xsl:value-of select=\"Name\"/>,<xsl:value-of select=\"Street\"/>,<xsl:value-of select=\"Zip\"/>,<xsl:value-of select=\"City\"/></li></xsl:if><xsl:if test=\"1 = position() mod 2\"><li style='color:green'><xsl:value-of select=\"Name\"/>,<xsl:value-of select=\"Street\"/>,<xsl:value-of select=\"Zip\"/>,<xsl:value-of select=\"City\"/></li></xsl:if></xsl:for-each></ul></BODY></HTML></xsl:template></xsl:stylesheet>"
        }
    ]
}