Exchange a local recovery token or username/password for an opaque session
POST/api/v1/session
The recovery token or password is accepted only in this JSON body and is never persisted by the session store. Browser requests are subject to same-origin Fetch Metadata and Origin checks. The returned credential is set as a host-only HttpOnly SameSite=Strict cookie.
Request
Responses
- 200
- 400
- 401
- 403
- 413
- 421
- 429
- 503
Authenticated and session cookie issued
Response Headers
Always no-store for credential responses
Opaque host-only HttpOnly SameSite=Strict Jiandu session cookie
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
Malformed JSON request
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The opaque credential is absent, ambiguous, malformed, expired, revoked, or invalid
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The browser mutation did not originate from this application, or the authenticated member lacks the required permission
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
A configured streaming body or per-file size limit was exceeded. A transport-level rejection may omit the JSON body.
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
The request authority or direct peer is outside the configured Jiandu ingress boundary
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
Interactive sign-in admission is temporarily exhausted
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.
A required core dependency is unavailable; retry with bounded backoff
Response Headers
Opaque request correlation identifier. ProblemDetails.requestId carries the same value on JSON failures.