Create Session (Legacy API)

The Legacy Create Session API is an API that matches the implementation of the /CreateSession endpoint of the previous Web Tier samples. This API is deprecated in PrizmDoc Application Services, and is available for backwards compatibility only. Please use the new ViewingSession API instead.

GET /CreateSession?document={document name}

Note that this URL is only available with Self-Hosted PrizmDoc.

Routes key: LegacyCreateSession

Creates a viewing session based on a specific document in storage.

GET pas_base_url/CreateSession?document=Sample.doc

To make the equivalent call using the new ViewingSession API:

POST pas_base_url/ViewingSession
Content-Type: application/json

{
    "source": {
        "type": "document",
        "fileName": "Sample.doc"
    }
}

Successful Response:

HTTP/1.1 200 OK
Content-Type: application/json

{
    "viewingSessionId": "XYZ..."
}

Errored Responses:

When the document does not exist:

HTTP/1.1 404 Not Found
Content-Type: application/json

{
    "errorCode": "DocumentNotFound"
}

When an unknown error occurs while gathering data:

HTTP/1.1 580 Server Error
Content-Type: application/json

{
    "errorCode": "InternalError"
}

GET /CreateSession?form={formDefinitionId}

Note that this URL is only available with Self-Hosted PrizmDoc.

Routes key: LegacyCreateSession

Creates a viewing session for the document referenced by a form definition.

GET pas_base_url/CreateSession?form=03f3e9c4a976419da576276acc427700

There is no equivalent to this call in the new ViewingSession API. Instead, the user should refer to the templateDocumentId field in the form definition JSON object, and use it as a document to create a viewing session.

Errored Responses:

When the form definition does not exist:

HTTP/1.1 404 Not Found
Content-Type: application/json

{
    "errorCode": "FormDefinitionNotFound"
}

When the document referenced by the form definition does not exist:

HTTP/1.1 404 Not Found
Content-Type: application/json

{
    "errorCode": "DocumentNotFound"
}

When an unknown error occurs while gathering data:

HTTP/1.1 580 Server Error
Content-Type: application/json

{
    "errorCode": "InternalError"
}