Skip to content

Commit 61a3d46

Browse files
wassimooclaude
wassimoo
and
claude
authored
feat: new sdk reference page with snippets (#2552)
* feat: inject TypeScript and Go SDK code samples into API reference Replaces the auto-generated axios/curl examples in the OpenAPI reference with idiomatic snippets pulled directly from the Ory SDK clients (@ory/client TypeScript and client-go). - Add scripts/inject-sdk-code-samples.mjs: reads TypeScript request interfaces from the TS SDK and Go examples from the pre-generated docs in the Go SDK (sdk/clients/client/go/docs/), then writes x-codeSamples into src/static/api.json for all 149 operations - Configure docusaurus.config.ts: add TypeScript and Go language tabs with correct codeSampleLanguage matching; include all Postman languages for the interactive explorer - Swizzle CodeSnippets and CodeTabs theme components to guard against empty variants arrays crashing <Tabs> - Regenerate docs/reference/openapi/ MDX from the updated spec Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com> * feat: add sdk reference for typescript and golang * fix: build and format * feat: use generated ts sdk docs * chore: fix format * feat: update sdk description and usage on language switch * feat: add python sdk reference * feat: update SDK documentation and code samples * feat: add sdk reference search * fix: switching lang tab breaks sdk page * feat: enhance SDK reference with new ApiExplorer component and styling updates * fix: update instruction for navigating SDK operations --------- Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 82d7475 commit 61a3d46

595 files changed

Lines changed: 121363 additions & 3644 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎docs/reference/openapi/accept-o-auth-2-consent-request.ParamsDetails.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"parameters": [
3+
{
4+
"description": "OAuth 2.0 Consent Request Challenge",
5+
"in": "query",
6+
"name": "consent_challenge",
7+
"required": true,
8+
"schema": { "type": "string" }
9+
}
10+
]
11+
}

‎docs/reference/openapi/accept-o-auth-2-consent-request.RequestSchema.json‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
{
2+
"title": "Body",
3+
"body": {
4+
"content": {
5+
"application/json": {
6+
"schema": {
7+
"properties": {
8+
"context": {
9+
"title": "JSONRawMessage represents a json.RawMessage that works well with JSON, SQL, and Swagger.",
10+
"type": "object"
11+
},
12+
"grant_access_token_audience": {
13+
"description": "GrantedAudience sets the audience the user authorized the client to use. Should be a subset of `requested_access_token_audience`.",
14+
"items": { "type": "string" },
15+
"type": "array"
16+
},
17+
"grant_scope": {
18+
"description": "GrantScope sets the scope the user authorized the client to use. Should be a subset of `requested_scope`.",
19+
"items": { "type": "string" },
20+
"type": "array"
21+
},
22+
"remember": {
23+
"description": "Remember, if set to true, tells ORY Hydra to remember this consent authorization and reuse it if the same\nclient asks the same user for the same, or a subset of, scope.",
24+
"type": "boolean"
25+
},
26+
"remember_for": {
27+
"description": "RememberFor sets how long the consent authorization should be remembered for in seconds. If set to `0`, the\nauthorization will be remembered indefinitely.",
28+
"format": "int64",
29+
"type": "integer"
30+
},
31+
"session": {
32+
"properties": {
33+
"access_token": {
34+
"description": "AccessToken sets session data for the access and refresh token, as well as any future tokens issued by the\nrefresh grant. Keep in mind that this data will be available to anyone performing OAuth 2.0 Challenge Introspection.\nIf only your services can perform OAuth 2.0 Challenge Introspection, this is usually fine. But if third parties\ncan access that endpoint as well, sensitive data from the session might be exposed to them. Use with care!"
35+
},
36+
"id_token": {
37+
"description": "IDToken sets session data for the OpenID Connect ID token. Keep in mind that the session'id payloads are readable\nby anyone that has access to the ID Challenge. Use with care!"
38+
}
39+
},
40+
"title": "Pass session data to a consent request.",
41+
"type": "object"
42+
}
43+
},
44+
"title": "The request payload used to accept a consent request.",
45+
"type": "object"
46+
}
47+
}
48+
},
49+
"x-originalParamName": "Body"
50+
}
51+
}

‎docs/reference/openapi/accept-o-auth-2-consent-request.StatusCodes.json‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
{
2+
"responses": {
3+
"200": {
4+
"content": {
5+
"application/json": {
6+
"schema": {
7+
"description": "Contains a redirect URL used to complete a login, consent, or logout request.",
8+
"properties": {
9+
"redirect_to": {
10+
"description": "RedirectURL is the URL which you should redirect the user's browser to once the authentication process is completed.",
11+
"type": "string"
12+
}
13+
},
14+
"required": ["redirect_to"],
15+
"title": "OAuth 2.0 Redirect Browser To",
16+
"type": "object"
17+
}
18+
}
19+
},
20+
"description": "oAuth2RedirectTo"
21+
},
22+
"default": {
23+
"content": {
24+
"application/json": {
25+
"schema": {
26+
"description": "Error",
27+
"properties": {
28+
"error": { "description": "Error", "type": "string" },
29+
"error_debug": {
30+
"description": "Error Debug Information\n\nOnly available in dev mode.",
31+
"type": "string"
32+
},
33+
"error_description": {
34+
"description": "Error Description",
35+
"type": "string"
36+
},
37+
"error_hint": {
38+
"description": "Error Hint\n\nHelps the user identify the error cause.",
39+
"example": "The redirect URL is not allowed.",
40+
"type": "string"
41+
},
42+
"status_code": {
43+
"description": "HTTP Status Code",
44+
"example": 401,
45+
"format": "int64",
46+
"type": "integer"
47+
}
48+
},
49+
"type": "object",
50+
"title": "errorOAuth2"
51+
}
52+
}
53+
},
54+
"description": "errorOAuth2"
55+
}
56+
}
57+
}

‎docs/reference/openapi/accept-o-auth-2-consent-request.api.mdx‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
id: accept-o-auth-2-consent-request
3+
title: "Accept OAuth 2.0 Consent Request"
4+
description: "When an authorization code, hybrid, or implicit OAuth 2.0 Flow is initiated, Ory asks the login provider"
5+
sidebar_label: "Accept OAuth 2.0 Consent Request"
6+
hide_title: true
7+
hide_table_of_contents: true
8+
api: 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
9+
sidebar_class_name: "put api-method"
10+
info_path: reference/openapi/ory-apis
11+
custom_edit_url: null
12+
---
13+
14+
import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint"
15+
import ParamsDetails from "@theme/ParamsDetails"
16+
import RequestSchema from "@theme/RequestSchema"
17+
import StatusCodes from "@theme/StatusCodes"
18+
import OperationTabs from "@theme/OperationTabs"
19+
import TabItem from "@theme/TabItem"
20+
import Heading from "@theme/Heading"
21+
import Translate from "@docusaurus/Translate"
22+
23+
<Heading as={"h1"} className={"openapi__heading"} children={"Accept OAuth 2.0 Consent Request"}></Heading>
24+
25+
<MethodEndpoint method={"put"} path={"/admin/oauth2/auth/requests/consent/accept"} context={"endpoint"}></MethodEndpoint>
26+
27+
When an authorization code, hybrid, or implicit OAuth 2.0 Flow is initiated, Ory asks the login provider to authenticate the
28+
subject and then tell Ory now about it. If the subject authenticated, he/she must now be asked if the OAuth 2.0 Client which
29+
initiated the flow should be allowed to access the resources on the subject's behalf.
30+
31+
The consent challenge is appended to the consent provider's URL to which the subject's user-agent (browser) is redirected to. The
32+
consent provider uses that challenge to fetch information on the OAuth2 request and then tells Ory if the subject accepted or
33+
rejected the request.
34+
35+
This endpoint tells Ory that the subject has authorized the OAuth 2.0 client to access resources on his/her behalf. The consent
36+
provider includes additional information, such as session data for access and ID tokens, and if the consent request should be used
37+
as basis for future requests.
38+
39+
The response contains a redirect URL which the consent provider should redirect the user-agent to.
40+
41+
The default consent provider is available via the Ory Managed Account Experience. To customize the consent provider, please head
42+
over to the OAuth 2.0 documentation.
43+
44+
<Heading id={"request"} as={"h2"} className={"openapi-tabs__heading"}>
45+
<Translate id="theme.openapi.request.title">Request</Translate>
46+
</Heading>
47+
48+
<ParamsDetails {...require("./accept-o-auth-2-consent-request.ParamsDetails.json")}></ParamsDetails>
49+
50+
<RequestSchema {...require("./accept-o-auth-2-consent-request.RequestSchema.json")}></RequestSchema>
51+
52+
<StatusCodes {...require("./accept-o-auth-2-consent-request.StatusCodes.json")}></StatusCodes>

‎docs/reference/openapi/accept-o-auth-2-login-request.ParamsDetails.json‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
{
2+
"parameters": [
3+
{
4+
"description": "OAuth 2.0 Login Request Challenge",
5+
"in": "query",
6+
"name": "login_challenge",
7+
"required": true,
8+
"schema": { "type": "string" }
9+
}
10+
]
11+
}

‎docs/reference/openapi/accept-o-auth-2-login-request.RequestSchema.json‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
{
2+
"title": "Body",
3+
"body": {
4+
"content": {
5+
"application/json": {
6+
"schema": {
7+
"properties": {
8+
"acr": {
9+
"description": "ACR sets the Authentication AuthorizationContext Class Reference value for this authentication session. You can use it\nto express that, for example, a user authenticated using two-factor authentication.",
10+
"type": "string"
11+
},
12+
"amr": {
13+
"description": "AMR sets the Authentication Methods References value for this\nauthentication session. You can use it to specify the method a user used to\nauthenticate. For example, if the acr indicates a user used two-factor\nauthentication, the amr can express they used a software-secured key.",
14+
"items": { "type": "string" },
15+
"type": "array"
16+
},
17+
"context": {
18+
"title": "JSONRawMessage represents a json.RawMessage that works well with JSON, SQL, and Swagger.",
19+
"type": "object"
20+
},
21+
"extend_session_lifespan": {
22+
"description": "Extend OAuth2 authentication session lifespan\n\nIf set to `true`, the OAuth2 authentication cookie lifespan is extended. This is for example useful if you want the user to be able to use `prompt=none` continuously.\n\nThis value can only be set to `true` if the user has an authentication, which is the case if the `skip` value is `true`.",
23+
"type": "boolean"
24+
},
25+
"force_subject_identifier": {
26+
"description": "ForceSubjectIdentifier forces the \"pairwise\" user ID of the end-user that authenticated. The \"pairwise\" user ID refers to the\n(Pairwise Identifier Algorithm)[http://openid.net/specs/openid-connect-core-1_0.html#PairwiseAlg] of the OpenID\nConnect specification. It allows you to set an obfuscated subject (\"user\") identifier that is unique to the client.\n\nPlease note that this changes the user ID on endpoint /userinfo and sub claim of the ID Token. It does not change the\nsub claim in the OAuth 2.0 Introspection.\n\nPer default, ORY Hydra handles this value with its own algorithm. In case you want to set this yourself\nyou can use this field. Please note that setting this field has no effect if `pairwise` is not configured in\nORY Hydra or the OAuth 2.0 Client does not expect a pairwise identifier (set via `subject_type` key in the client's\nconfiguration).\n\nPlease also be aware that ORY Hydra is unable to properly compute this value during authentication. This implies\nthat you have to compute this value on every authentication process (probably depending on the client ID or some\nother unique value).\n\nIf you fail to compute the proper value, then authentication processes which have id_token_hint set might fail.",
27+
"type": "string"
28+
},
29+
"identity_provider_session_id": {
30+
"description": "IdentityProviderSessionID is the session ID of the end-user that authenticated.\nIf specified, we will use this value to propagate the logout.",
31+
"type": "string"
32+
},
33+
"remember": {
34+
"description": "Remember, if set to true, tells Ory Hydra to remember this user by telling the user agent (browser) to store\na cookie with authentication data. If the same user performs another OAuth 2.0 Authorization Request, they\nwill not be asked to log in again.",
35+
"type": "boolean"
36+
},
37+
"remember_for": {
38+
"description": "RememberFor sets how long the authentication should be remembered for in seconds. If set to `0`, the\nauthorization will be remembered for the duration of the browser session (using a session cookie).",
39+
"format": "int64",
40+
"type": "integer"
41+
},
42+
"subject": {
43+
"description": "Subject is the user ID of the end-user that authenticated.",
44+
"type": "string"
45+
}
46+
},
47+
"required": ["subject"],
48+
"title": "HandledLoginRequest is the request payload used to accept a login request.",
49+
"type": "object"
50+
}
51+
}
52+
},
53+
"x-originalParamName": "Body"
54+
}
55+
}

‎docs/reference/openapi/accept-o-auth-2-login-request.StatusCodes.json‎

Lines changed: 57 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
{
2+
"responses": {
3+
"200": {
4+
"content": {
5+
"application/json": {
6+
"schema": {
7+
"description": "Contains a redirect URL used to complete a login, consent, or logout request.",
8+
"properties": {
9+
"redirect_to": {
10+
"description": "RedirectURL is the URL which you should redirect the user's browser to once the authentication process is completed.",
11+
"type": "string"
12+
}
13+
},
14+
"required": ["redirect_to"],
15+
"title": "OAuth 2.0 Redirect Browser To",
16+
"type": "object"
17+
}
18+
}
19+
},
20+
"description": "oAuth2RedirectTo"
21+
},
22+
"default": {
23+
"content": {
24+
"application/json": {
25+
"schema": {
26+
"description": "Error",
27+
"properties": {
28+
"error": { "description": "Error", "type": "string" },
29+
"error_debug": {
30+
"description": "Error Debug Information\n\nOnly available in dev mode.",
31+
"type": "string"
32+
},
33+
"error_description": {
34+
"description": "Error Description",
35+
"type": "string"
36+
},
37+
"error_hint": {
38+
"description": "Error Hint\n\nHelps the user identify the error cause.",
39+
"example": "The redirect URL is not allowed.",
40+
"type": "string"
41+
},
42+
"status_code": {
43+
"description": "HTTP Status Code",
44+
"example": 401,
45+
"format": "int64",
46+
"type": "integer"
47+
}
48+
},
49+
"type": "object",
50+
"title": "errorOAuth2"
51+
}
52+
}
53+
},
54+
"description": "errorOAuth2"
55+
}
56+
}
57+
}

0 commit comments

Comments
 (0)