Read authorized document detail

GET 
/api/v1/documents/:document_id

Requires documents.read and the current document ACL. Unknown and unauthorized identifiers are indistinguishable; the response includes canonical detail and history with a strong revision ETag.

Request

Responses

200

Canonical detail, provenance, history, and safe use descriptors

Response Headers

ETag

Strong decimal revision required by document mutations

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

401

The opaque credential is absent, ambiguous, malformed, expired, revoked, or invalid

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

403

The browser mutation did not originate from this application, or the authenticated member lacks the required permission

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

404

The resource is unknown or outside the authenticated household scope

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.

421

The request authority or direct peer is outside the configured Jiandu ingress boundary

Response Headers

X-Request-Id

Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.