Introduction

The ArchiveService API can be used to access documents that are stored in Signicat’s archive.

All documents in the archive is identified with a unique archive reference. The archive reference is neccesary to access the document. Documents has no metadata and there is no functionality for searching for documents.

Location

The WSDL for the service is available at:

Infrastructure
Location
Pre-production https://preprod.signicat.com/ws/archiveservice-v3?wsdl
Production https://id.signicat.com/ws/archiveservice-v3?wsdl

The only difference between the wsdl in preprod and production is the soap address location attribute.

List of methods

Method
Description
getDocument Used for retrieving a document from the archive.
removeDocument Used for removing a document in the archive.

Mandatory parameters in all requests

All requests requires these mandatory parameters for authentication.

Name
Data type
Description
version String Should be “3.0”
service String The name of the customer service (the customer account).
password String The password for this service. This is different in preprod and production.

getDocument

Purpose

This method is used for retrieving a document from the archive.

Parameters

Name
Data type
Description
archive-id String Unique archive identifier. Identifies the document to be retrieved.

Return value

Name
Data type
Description
archive-id String Unique archive identifier. Identifies the document to be retrieved.
mime-type String The document’s mime-type.
data Base64 Base64 encoded binary data. This is the document.

removeDocument

Purpose

This method is used for removing a document in the archive.

The service will try to remove all documents in the input list. The return value will list all documents that was actually removed.

This method will accept an archive-id that does not exist. In the case of failure, this method call can be repeated with the same input several times.

Parameters

Name
Data type
Description
archive-id List of String A list of unique archive-id’s for the documents to be removed.

Return value

Name
Data type
Description
archive-id List of String A list of unique archive-id’s for the documents that actually was removed.