Estos tres endpoints emiten y gestionan las credenciales que el paquete DQE One para Salesforce utiliza para llamar al resto de la API One: un token de proceso de corta duración, un flujo de suscripción (incorporación) de organización/usuario, y un token de sesión para la interfaz personalizada del paquete.
Envía un cuerpo JSON a este endpoint con la cabecera DQE-Authorization configurada.
{DOMAIN} es el dominio del servidor donde está instalada la instancia propia del backend de DQE One de tu organización — dado que este backend se ejecuta en tu propia infraestructura, este valor lo determina tu despliegue, no lo emite DQE. {DQE_AUTHORIZATION_KEY} es proporcionado por DQE al configurar la cuenta/el paquete; contacta con tu gestor de cuenta de DQE para obtenerlo.
using var client = new HttpClient();
var json = "{\"orgId\":\"00D5e0000008abcEAA\",\"crt\":\"2026-10-28T10:15:00Z\",\"sub\":\"0055e00000AbCnoFAF\",\"aud\":\"dqe-unify-api\",\"urllogin\":\"https://login.salesforce.com\"}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
using var request = new HttpRequestMessage(HttpMethod.Post, "https://{DOMAIN}/getOAuthTokenForProcess");
request.Headers.Add("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}");
request.Content = content;
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
Todos los campos se envían como un único cuerpo de solicitud JSON.
Nota sobre Obligatorio/Opcional: la especificación OpenAPI de origen no declara un array required para este cuerpo de solicitud (solo el cuerpo en su conjunto está marcado como obligatorio). Todos los campos siguientes se muestran como Obligatorios según la convención de documentación de este proyecto y porque cada uno desempeña un papel definido en el flujo de emisión del token — confirma la opcionalidad real con el equipo de ingeniería de DQE antes de publicar.
Campo
Descripción
Tipo
Obl. / Opc.
orgId
El ID de la organización de Salesforce que realiza la solicitud.
String
Obligatorio
crt
La reivindicación de marca de tiempo de creación/emisión para esta solicitud firmada.
String
Obligatorio
sub
La reivindicación de sujeto — el identificador de usuario o sesión de Salesforce que emite la solicitud.
String
Obligatorio
aud
La reivindicación de audiencia — el servicio destinatario/objetivo previsto para esta solicitud firmada.
String
Obligatorio
urllogin
La URL de inicio de sesión de la organización de Salesforce.
String
Obligatorio
Respuesta
Devuelve un objeto JSON que contiene el token de proceso.
Clave
Descripción
Tipo
Token
El token generado, utilizado para autenticar la siguiente llamada del proceso.
String
Ejemplo de respuesta
Ejemplo de respuesta con token
{
"Token": "token"
}
El único valor de ejemplo de la especificación de origen para Token es la cadena de marcador de posición literal "token" — se muestra tal cual arriba, en lugar de sustituirla por un valor de aspecto inventado.
Errores
La especificación de origen no define ninguna respuesta de error (4xx/5xx) para este endpoint — solo está documentada la respuesta de éxito 200. Confirma el comportamiento real de los errores con el equipo de ingeniería de DQE antes de publicar.
Probar la API
Haz clic en el botón de abajo para probar este endpoint en vivo desde tu navegador.
Abrir consola
Subscription - DQE One API
Registra una organización o usuario de Salesforce y devuelve las credenciales necesarias para las siguientes llamadas autenticadas. Esto parece un flujo de incorporación/registro de la organización, más que un paso de autenticación por llamada.
Envía un cuerpo JSON a este endpoint. No se requiere ninguna cabecera de autenticación — la especificación de origen declara un requisito de seguridad vacío para esta ruta.
{DOMAIN} es el dominio del servidor donde está instalada la instancia propia del backend de DQE One de tu organización — dado que este backend se ejecuta en tu propia infraestructura, este valor lo determina tu despliegue, no lo emite DQE.
using var client = new HttpClient();
var json = "{\"orgId\":\"00D5e0000008abcEAA\",\"groupId\":\"GRP-00123\",\"licence\":\"123456\",\"region\":\"EU\",\"key\":\"a1b2c3d4e5f6\"}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
var response = await client.PostAsync("https://{DOMAIN}/subscribe", content);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
Todos los campos se envían como un único cuerpo de solicitud JSON.
Nota sobre Obligatorio/Opcional: la especificación OpenAPI de origen no declara un array required para este cuerpo de solicitud (solo el cuerpo en su conjunto está marcado como obligatorio). Todos los campos siguientes se muestran como Obligatorios según la convención de documentación de este proyecto — confirma la opcionalidad real con el equipo de ingeniería de DQE antes de publicar.
Campo
Descripción
Tipo
Obl. / Opc.
orgId
El ID de la organización de Salesforce que se está registrando.
String
Obligatorio
groupId
Identificador del grupo de licencia/instancia de paquete bajo el cual se suscribe esta organización.
String
Obligatorio
licence
El código de licencia de DQE asociado a esta suscripción.
String
Obligatorio
region
La región o centro de datos donde debe aprovisionarse la instancia de DQE de esta organización.
String
Obligatorio
key
Una clave de activación o suscripción utilizada para validar la solicitud de registro.
Deducido únicamente a partir del nombre del campo — su finalidad exacta no está documentada en la especificación de origen.
String
Obligatorio
Respuesta
Devuelve un objeto JSON que contiene las credenciales emitidas para esta suscripción.
Clave
Descripción
Tipo
pwd
La contraseña emitida como parte de las nuevas credenciales devueltas por este registro.
String
iss
El identificador de emisor asignado a la organización/usuario recién registrado — se utiliza como parte de las credenciales para las siguientes llamadas autenticadas.
String
issSecret
El secreto asociado al identificador de emisor. Guárdalo de forma segura; autoriza las llamadas posteriores.
String
crt
La marca de tiempo de creación/emisión de estas credenciales.
String
groupId
El identificador de grupo confirmado para esta suscripción (repite el valor de la solicitud).
La especificación de origen no proporciona valores de example para este esquema. Los valores anteriores son solo marcadores de posición ilustrativos — no se documenta ningún formato o longitud específicos.
Errores
La especificación de origen no define ninguna respuesta de error (4xx/5xx) para este endpoint — solo está documentada la respuesta de éxito 200. Confirma el comportamiento real de los errores con el equipo de ingeniería de DQE antes de publicar.
Probar la API
Haz clic en el botón de abajo para probar este endpoint en vivo desde tu navegador.
Abrir consola
Sesión de la interfaz personalizada - API DQE One
Crea un token de sesión para la interfaz personalizada integrada del paquete DQE One, limitado a una sesión y un usuario de Salesforce específicos.
Envía un cuerpo JSON a este endpoint con la cabecera DQE-Authorization configurada.
{DOMAIN} es el dominio del servidor donde está instalada la instancia propia del backend de DQE One de tu organización — dado que este backend se ejecuta en tu propia infraestructura, este valor lo determina tu despliegue, no lo emite DQE. {DQE_AUTHORIZATION_KEY} es proporcionado por DQE al configurar la cuenta/el paquete; contacta con tu gestor de cuenta de DQE para obtenerlo.
POSThttps://{DOMAIN}/customUI/createTokenSession
Ejemplos de código
Crear un token de sesión de la interfaz personalizada
using var client = new HttpClient();
var json = "{\"orgId\":\"00D5e0000008abcEAA\",\"aud\":\"dqe-unify-api\",\"urllogin\":\"https://login.salesforce.com\",\"sub\":\"0055e00000AbCnoFAF\",\"name\":\"Jane Doe\",\"sessionId\":\"00D5e0000008abcEAA!AQEAQJ3x9fKZ\",\"licence\":\"123456\",\"region\":\"EU\",\"isPersonAccountEnable\":false,\"chatterId\":\"0D55e00000ABCDEFG\",\"setTokenToUi\":true}";
var content = new StringContent(json, Encoding.UTF8, "application/json");
using var request = new HttpRequestMessage(HttpMethod.Post, "https://{DOMAIN}/customUI/createTokenSession");
request.Headers.Add("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}");
request.Content = content;
var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
Todos los campos se envían como un único cuerpo de solicitud JSON.
Nota sobre Obligatorio/Opcional: la especificación OpenAPI de origen no declara un array required para este cuerpo de solicitud (solo el cuerpo en su conjunto está marcado como obligatorio). Todos los campos siguientes se muestran como Obligatorios según la convención de documentación de este proyecto — confirma la opcionalidad real con el equipo de ingeniería de DQE antes de publicar.
Campo
Descripción
Tipo
Obl. / Opc.
orgId
El ID de la organización de Salesforce que realiza la solicitud.
String
Obligatorio
aud
La reivindicación de audiencia — el servicio destinatario/objetivo previsto para esta solicitud firmada.
String
Obligatorio
urllogin
La URL de inicio de sesión de la organización de Salesforce.
String
Obligatorio
sub
La reivindicación de sujeto — el identificador de usuario o sesión de Salesforce que emite la solicitud.
String
Obligatorio
name
Nombre para mostrar asociado a la sesión (por ejemplo, el nombre del usuario de Salesforce).
String
Obligatorio
sessionId
Identificador de la sesión de Salesforce a la que está vinculado este token de la interfaz personalizada.
String
Obligatorio
licence
El código de licencia de DQE asociado a esta organización.
String
Obligatorio
region
La región o centro de datos de la organización de Salesforce o de la instancia de DQE.
String
Obligatorio
isPersonAccountEnable
Indica si las cuentas personales (Person Accounts) están habilitadas en la organización de Salesforce que realiza la llamada.
Boolean
Obligatorio
chatterId
Identificador de un registro de Salesforce Chatter (por ejemplo, un elemento del feed) asociado a esta sesión.
Deducido únicamente a partir del nombre del campo — su finalidad exacta no está documentada en la especificación de origen.
String
Obligatorio
setTokenToUi
Indica si el token generado debe escribirse directamente en la sesión de la interfaz personalizada, en lugar de devolverse únicamente en la respuesta de la API.
Deducido únicamente a partir del nombre del campo.
Boolean
Obligatorio
Respuesta
Devuelve un objeto JSON que describe el token de sesión de la interfaz personalizada creado.
Clave
Descripción
Tipo
status
Estado del resultado de la solicitud de creación de la sesión.
String
uuidToken
El token de sesión generado, utilizado para autenticar la sesión de la interfaz personalizada.
El nombre del campo sugiere un formato UUID, pero esto no está confirmado por la especificación de origen.
String
name
Repite el nombre de sesión/usuario asociado al token creado.
String
isUiLocal
Indica si la sesión de la interfaz personalizada se está ejecutando en modo local en lugar de contra el entorno alojado de DQE.
Deducido únicamente a partir del nombre del campo — no confirmado por la especificación de origen.
La especificación de origen no proporciona valores de example para este esquema. Los valores anteriores son solo marcadores de posición ilustrativos.
Errores
La especificación de origen no define ninguna respuesta de error (4xx/5xx) para este endpoint — solo está documentada la respuesta de éxito 200. Confirma el comportamiento real de los errores con el equipo de ingeniería de DQE antes de publicar.
Probar la API
Haz clic en el botón de abajo para probar este endpoint en vivo desde tu navegador.