# Downloading from SDS

In order to transfer a file from SDS, you execute an HTTP GET request which needs to contain the following information:

  1. Credentials — the requests are authenticated using basic authentication, where the username is your service name and the password is the same as in your web service requests. Signicat Support will help you acquire the correct credentials for your integration. In production you will need a client certificate as well. See How to get a client SSL web service certificate for step-by-step instructions.
  2. The URL — contains the document id and will have the following format: https://environment.signicat.com/doc/servicename/sds/documentid where the fragments written in italic are subject to change.

# Example HTTP request

GET https://preprod.signicat.com/doc/demo/sds/260820133373l363x69jzc74qs3vo2hittigyd0spy1wwk60rk6z70278m HTTP/1.1
Authorization: Basic ZGVtbzpCb25kMDA3
Host: preprod.signicat.com

# Example HTTP response

HTTP/1.1 200 OK
Date: Mon, 26 Aug 2013 11:40:07 GMT
Content-Type: application/pdf
Content-Length: 688343

%PDF-1.5
%âãÏÓ
1 0 obj
<</Metadata 2 0 R/OCProperties<</D<</OFF[10 0 R 11 0 R 12 0 R]/ON[13 0 R 14 0 R 15 0 R 16 0 R 17 0 R 18 0 R 19 0 R 20 0 R 21 0 R 22 0 R 23 0 R 24 0 R 25 0 R 26 0 R 27 0 R 28 0 R 29 0 R 30 0 R]/Order 31 0 R/RBGroups[]>>/OCGs[10 0 R 13 0 R 14 0 R 15 0 R 16 0 R 17 0 R 18 0 R 11 0 R 19 0 R 20 0 R 21 0 R 22 0 R 23 0 R 12 0 R 24 0 R 25 0 R 26 0 R 27 0 R 28 0 R 29 0 R 30 0 R]>>/Pages 3 0 R/Type/Catalog>>
[a lot of PDF mumbo jumbo here] >>
startxref
683190
%%EOF

# Reponse codes

A successful request results in a HTTP 200 OK response. Other HTTP codes you may receive are:

  • HTTP 400 Bad Request – Your request is syntactically incorrect and could not be understood by the server.
  • HTTP 404 Not Found — the document corresponding to the given document id could not be found.
  • HTTP 500 Internal Server Error — the service failed to complete your request for undisclosed reasons.
Last updated: 3/1/2021, 12:00:45 AM