GETPublic

Open a shared document

/api/edm/shared/{token}

Public share link. No Bearer token. Optional password query.

Invalid, revoked, expired, or exhausted tokens all return 404 share_invalid (same message — anti-enumeration). Wrong or missing password → 401 share_password_required. Success returns a short-lived signed download URL (expires_in 300 seconds) and document_name.

Path parameters

Field	Type	Description
token Required	string	Path parameter `token`.

Query parameters

Field	Type	Description
password	string	Share password when the link is protected.

Request body

This endpoint does not accept a request body.

Responses

Status	Meaning
200	See the example response.
401	Missing or invalid Bearer token.

Request

curl

curl -X GET 'https://api.dkbsigns.com/api/edm/shared/example?password=P%40ssw0rd%21'

Response 200

json

{
  "url": "https://files.example/signed-download",
  "expires_in": 300,
  "document_name": "Contract 2026.pdf"
}