Servicios

Clave unica

Creación de URI principal

Método: GET
Ruta: https://accounts.claveunica.gob.cl/openid/authorize/
Parámetros:
client_id: Identificador de la integración. Credencial solicitada a la secretaría del Estado.
response_type: Misma lógica de la capa OpenID Connect del protocolo OAuth 2.0, en el cual este parámetro recibe un código de autorización de un solo uso, que luego es intercambiado por un "token de acceso".
scope: Permite obtener la información del ciudadano (run y nombre completo). Debe ser openid run name.
redirect_uri: En este parámetro va la URI de la aplicación a la que estamos integrando con ClaveÚnica.
state: Token de inicio de sesión. \

Ejemplos de URI compuesta:

https://accounts.claveunica.gob.cl/openid/authorize/?client_id=Wbgx7HkjoeU6uarez3uYnn41V mGkd600&response_type=code&scope=openid run name&redirect_uri=https%3A%2F%2Fintegrador.cl%2Fcallback&state=abcdefgh

Explicación de uso:

Este endpoint es usado para el comienzo del proceso de autorización de la solicitud (como bien dice la propia ruta), generando una URI que será aquella que, mediante la generación de tokens de acceso, nos dará acceso al endpoint de solicitud de información del ciudadano.

---

Consultar información ciudadano

Método: POST
Ruta: https://accounts.claveunica.gob.cl/openid/userinfo/

Ejemplo de solicitud y respuesta:

curl -i https://accounts.claveunica.gob.cl/openid/userinfo/ -X POST -H "authorization: Bearer 2718e590ec7e47858e4af5922050d28b" JavaScript

{ 
	"sub": "1234567",
	"RolUnico": {
		"DV": "9",
		"numero": 12345678,
		"tipo": "RUN"
	}, 
	"name": {
		"apellidos": [
			 "Del Río",
			"Gonzalez"
		], 
		"nombres": [ 
			"María",
			"Carmen"
		] 
	} 
}

Explicación de uso:

Es el endpoint que más queremos usar pues es mediante el cual consultamos y creamos una estructura json donde tendremos los datos de los usuarios que hayan decidido realizar la firma digital mediante ClaveÚnica.

---

Diagrama de secuencia de interacción completa con API

Endpoints internos

POST /api/auth/login

Para iniciar sesion solicita los siguientes campos:

Campo Tipo Obligatorio email string si
password string si

{
  "email": "usuario@example.com",
  "password": "123456"
}

POST /api/auth/register

Registra un nuevo usuario. { "nombre": "ejemplo ejemplo", "email": "ejemplo@example.com", "password": "123456", "telefono": "91234567", "rut": "12.345.678-9", "direccion": "Av. holamundo 123" }

GET /api/user

Obtiene los datos del urusario autenticado.

{
  "id": 5,
  "nombre": "ejemplo ejemplo",
  "email": "ejemplo@example.com",
  "rut": "12.345.678-9",
  "telefono": "912345678",
}

POST /api/user/documents

Sube documentos del usuario como carnet:

Request FormData Debe enviarse con multipart/form-data

POST /api/loans/simulate

Simula un prestamo, el request tiene los siguientes campos:

Campo Tipo Obligatorio amount number sí term number sí

{
  "message": "Documentos subidos",
  "files": 
  {
    "cedula": "...",
  }
}

POST /api/loans/submit

Envía la solicitud formal de préstamo.

Request

El payload contiene la información del formulario completo.

GET /api/loans/:id/status

Obtiene el estado de una solicitud de prestamo, donde los estados pueden ser:

-revision -aprobado -rechazado -documentos pendientes