> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercambiar un código de autorización por un token

> Intercambie un código de autorización por un token de acceso después de que se redirija al usuario de vuelta a su URL de callback.

export const ResponseSchema = ({statusCode, type = "{}", children}) => {
  const [open, setOpen] = useState(false);
  return <div className="border border-gray-100 dark:border-gray-800 rounded-lg mb-3 overflow-hidden">
      <div className={`flex items-center gap-2.5 px-4 py-2.5 cursor-pointer select-none ${open ? "bg-gray-50 dark:bg-gray-800" : ""}`} onClick={() => setOpen(!open)}>
        {statusCode && <span className="border border-gray-300 dark:border-gray-600 text-gray-700 dark:text-gray-300 font-mono text-xs px-1.5 py-0.5 rounded">
            {statusCode.startsWith("default") ? "default" : statusCode}
          </span>}
        <span className="text-gray-500 dark:text-gray-400 text-sm font-mono">
          {type}
        </span>
        <span className="text-gray-400 dark:text-gray-500 text-sm italic">
          application/json
        </span>
        <svg className={`ml-auto opacity-50 transition-transform duration-200 ${open ? "rotate-180" : ""}`} width="16" height="16" viewBox="0 0 16 16" fill="none">
          <path d="M4 6l4 4 4-4" stroke="currentColor" strokeWidth="1.5" strokeLinecap="round" strokeLinejoin="round" />
        </svg>
      </div>
      {open && <div className="px-4 pt-1 pb-3 border-t border-gray-100 dark:border-gray-800">
          {children}
        </div>}
    </div>;
};

<div id="endpoint">
  ## Endpoint
</div>

`POST /oauth/token`

Cuando se redirija a los usuarios de vuelta a su URL de callback, debe realizar una llamada `POST` al endpoint `oauth/token` para intercambiar un código de autorización por un token de acceso y/o un token de ID.

<div id="remarks">
  ### Observaciones
</div>

Para realizar una llamada al endpoint `/oauth/token`, debe:

* Establecer el tipo de contenido de la solicitud en `application/x-www-form-urlencoded`
* Usar valores de tipo `string` para todos los parámetros enviados
* Incluir en la solicitud un parámetro adicional para la autenticación de la aplicación (por ejemplo, `client_secret`, o `client_assertion` y `client_assertion_type` para la autenticación de cliente con JSON Web Token, o enviar los encabezados `client-certificate` y `client-certificate-ca-verified` al usar Mutual TLS).

<div id="headers">
  ## Encabezados
</div>

<ParamField header="DPoP" type="string">
  Una prueba DPoP para la solicitud. Es opcional y solo se requiere si su aplicación usa Demonstrating Proof-of-Possession.
</ParamField>

<div id="body-parameters">
  ## Parámetros del cuerpo
</div>

<ParamField body="grant_type" type="string" required>
  Indica el flujo; utilice `authorization_code` con un código de autorización válido.
</ParamField>

<ParamField body="code" type="string">
  El código de autorización obtenido en la llamada inicial a `/authorize`.
</ParamField>

<ParamField body="client_id" type="string" required>
  El `client_id` de su aplicación. Obligatorio.
</ParamField>

<ParamField body="request_uri" type="string">
  Solo es obligatorio si se estableció en el endpoint `GET` `/oauth/par`.
</ParamField>

<ParamField body="code_verifier" type="string">
  Clave aleatoria criptográficamente segura que se utiliza para generar el `code_challenge`. Se recomienda si se proporcionó `code_challenge`.
</ParamField>

<div id="response-schema">
  ## Esquema de respuesta
</div>

<ResponseSchema>
  <ResponseField name="access_token" type="string">
    Token de acceso para recursos protegidos.
  </ResponseField>

  <ResponseField name="refresh_token" type="string">
    Token utilizado para obtener nuevos tokens de acceso.
  </ResponseField>

  <ResponseField name="id_token" type="string">
    El token de ID.
  </ResponseField>

  <ResponseField name="token_type" type="string">
    El tipo de token. Normalmente, `Bearer`.
  </ResponseField>

  <ResponseField name="expires_in" type="integer">
    La duración del token de acceso en segundos.
  </ResponseField>
</ResponseSchema>

<div id="response-messages">
  ## Mensajes de respuesta
</div>

| Estado | Descripción                                      |
| ------ | ------------------------------------------------ |
| 200    | Respuesta satisfactoria que contiene los tokens. |