OAuth & Consent

OAuth 2.0 authorization endpoints including PKCE flow, token exchange, consent management, and token revocation.

post

Body

application/json

computed_atstringRequired

Responses

200Success

application/json

post

/consent/presets

HTTPcURLJavaScriptPython

POST /samchon/nestia/consent/presets HTTP/1.1
Host: github.com
Content-Type: application/json
Accept: */*
Content-Length: 63

{
  "presets": [
    {
      "name": null,
      "value": "text"
    }
  ],
  "computed_at": "text"
}

200Success

{
  "accepted": true,
  "expires_at": "text"
}

get

Query parameters

client_idstringRequired

redirect_uristringRequired

response_typeconst: codeRequired

scopestringRequired

statestringOptional

code_challengestringRequired

code_challenge_methodconst: S256Required

authorization_idstringOptional

login_hintstringOptional

localestringOptional

noncestringOptional

Responses

200Success

application/json

get

/oauth/authorize

HTTPcURLJavaScriptPython

GET /samchon/nestia/oauth/authorize?client_id=text&redirect_uri=text&response_type=null&scope=text&code_challenge=text&code_challenge_method=null HTTP/1.1
Host: github.com
Accept: */*

200Success

post

Body

application/json

or

Responses

200Success

application/json

post

/oauth/token

HTTPcURLJavaScriptPython

POST /samchon/nestia/oauth/token HTTP/1.1
Host: github.com
Content-Type: application/json
Accept: */*
Content-Length: 97

{
  "grant_type": null,
  "code": "text",
  "redirect_uri": "text",
  "client_id": "text",
  "code_verifier": "text"
}

200Success

{
  "access_token": "text",
  "token_type": null,
  "expires_in": 1,
  "scope": "text",
  "granted_scopes": [
    "text"
  ],
  "authorization_id": "text",
  "app_scoped_user_id": "text",
  "issued_at": "text",
  "refresh_token": "text",
  "refresh_token_expires_in": 1,
  "refresh_issued_at": "text",
  "id_token": "text"
}

post

Body

application/json

client_idstringRequired

client_secretstringRequired

identifierstringOptional

user_idstringOptional

emailstringOptional

evm_addressstringOptional

Responses

200Success

application/json

post

/oauth/client/user-token

HTTPcURLJavaScriptPython

POST /samchon/nestia/oauth/client/user-token HTTP/1.1
Host: github.com
Content-Type: application/json
Accept: */*
Content-Length: 116

{
  "client_id": "text",
  "client_secret": "text",
  "identifier": "text",
  "user_id": "text",
  "email": "text",
  "evm_address": "text"
}

200Success

{
  "access_token": "text",
  "token_type": null,
  "expires_in": 1,
  "issued_at": "text",
  "user_id": "text",
  "client_id": "text",
  "authorization_id": "text",
  "scopes": [
    "text"
  ]
}

get

Query parameters

authorization_idstringRequired

Responses

200Success

application/json

get

/oauth/authorize/context

HTTPcURLJavaScriptPython

GET /samchon/nestia/oauth/authorize/context?authorization_id=text HTTP/1.1
Host: github.com
Accept: */*

200Success

{
  "authorization_id": "text",
  "client_id": "text",
  "user_id": "text",
  "app_scoped_user_id": "text",
  "status": null,
  "redirect_uri": "text",
  "state": "text",
  "requested_scopes": [
    "text"
  ],
  "granted_scopes": [
    "text"
  ],
  "code": "text",
  "code_expires_at": "text",
  "nonce": "text",
  "application": {
    "client_id": "text",
    "name": "text",
    "organization_id": "text",
    "status": null,
    "redirect_uris": [
      "text"
    ],
    "created_by_user_id": "text",
    "created_at": "text",
    "updated_at": "text",
    "revoked_at": "text"
  },
  "scopes": [
    {
      "id": "text",
      "display_name": "text",
      "description": "text",
      "category": "text",
      "implied_scopes": [
        "text"
      ],
      "is_default": true
    }
  ],
  "metadata": {
    "created_at": "text",
    "updated_at": "text",
    "approved_at": "text",
    "revoked_at": "text",
    "last_token_issued_at": "text"
  },
  "policy": {
    "requires_palm_verification": true,
    "preset_cache_ttl_seconds": 1
  }
}

get

Query parameters

authorization_idstringRequired

Responses

200Success

application/json

get

/oauth/authorize/result

HTTPcURLJavaScriptPython

GET /samchon/nestia/oauth/authorize/result?authorization_id=text HTTP/1.1
Host: github.com
Accept: */*

200Success

post

Body

application/json

tokenstringOptional

tokensstring[]Optional

token_type_hintone ofOptional

const: authorizationOptional

or

const: refresh_tokenOptional

or

const: access_tokenOptional

authorization_idstringOptional

cascadeone ofOptional

const: trueOptional

or

const: falseOptional

or

const: 1Optional

or

const: 0Optional

or

booleanOptional

client_idstringOptional

Responses

200Success

application/json

post

/oauth/revoke

HTTPcURLJavaScriptPython

POST /samchon/nestia/oauth/revoke HTTP/1.1
Host: github.com
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "token": "text",
  "tokens": [
    "text"
  ],
  "token_type_hint": null,
  "authorization_id": "text",
  "cascade": null,
  "client_id": "text"
}

200Success

{
  "revoked": true,
  "revoked_count": 1,
  "details": [
    {
      "subject": null,
      "token_type": null,
      "authorization_id": "text",
      "client_id": "text",
      "user_id": "text",
      "status": null,
      "reason": "text"
    }
  ]
}

post

Body

application/json

authorization_idstringRequired

scopesstring[]Optional

Responses

200Success

application/json

post

/oauth/authorize/approve

HTTPcURLJavaScriptPython

POST /samchon/nestia/oauth/authorize/approve HTTP/1.1
Host: github.com
Content-Type: application/json
Accept: */*
Content-Length: 45

{
  "authorization_id": "text",
  "scopes": [
    "text"
  ]
}

200Success

{
  "authorization_id": "text",
  "status": null,
  "code": "text",
  "code_expires_at": "text",
  "scopes": [
    "text"
  ],
  "granted_scopes": [
    "text"
  ],
  "app_scoped_user_id": "text",
  "organization_id": "text",
  "state": "text",
  "redirect_uri": "text",
  "client_id": "text"
}

post

Body

application/json

authorization_idstringRequired

reasonstringOptional

Responses

200Success

application/json

post

/oauth/authorize/deny

HTTPcURLJavaScriptPython

POST /samchon/nestia/oauth/authorize/deny HTTP/1.1
Host: github.com
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "authorization_id": "text",
  "reason": "text"
}

200Success

{
  "authorization_id": "text",
  "status": "text",
  "redirect_uri": "text",
  "state": "text",
  "client_id": "text"
}