link

# ArchiveService v3

# Introduction

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

All documents in the archive are identified with a unique archive reference. The archive reference is necessary to access the document. Documents have 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 (opens new window)
Production https://id.signicat.com/ws/archiveservice-v3?wsdl (opens new window)

# List of methods

Method Description
getDocument https://preprod.signicat.com/ws/archiveservice-v3?wsdl (opens new window)
removeDocument https://id.signicat.com/ws/archiveservice-v3?wsdl (opens new window)

# Mandatory parameters in all requests

All requests require 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 the service. This is different in pre-production 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.

Important

You must manage each archive-id in your own system and map it to the relevant document.

If you do not know your archive-id and would like to retrieve an archived document, or if you would like to get a list of all your archive IDs, contact us at support@signicat.com. This service will entail additional costs. With the archive-id, you can then retrieve the corresponding archived document yourself.

# removeDocument

# Purpose

This method is used for removing a document from the archive. The service will try to remove all documents in the input list. The return value will list all documents that were successfully removed.

# Parameters

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

# Return value

Name Data type Description
archive-id List of String A list of unique archive-ids for the documents that were successfully removed.

Important

You must manage each archive-id in your own system and map it to the relevant document.

If you do not know your archive-id and would like to delete an archived document, or if you would like to get a list of all your archive IDs, contact us at support@signicat.com. This service will entail additional costs. With the archiveID, you can then delete the corresponding archived document yourself.

Last updated: 07/02/2024 12:18 UTC