Consultar cupo del usuario por NIT

Consultar cupo del usuario por NIT #

Este método permite encontrar el cupo de un usuario en la base de datos de LeanCore a través de su NIT o número de identificación.

URL del endpoint #

GET /get-user-quota

Parámetros de entrada #

Parámetro Tipo Descripción
nit string NIT o número de identificación del usuario

Encabezados #

Encabezado Valor
Authorization Bearer {token}
Content-Type application/json

Respuesta esperada #

El método devuelve una respuesta en formato JSON con los siguientes campos:

  • En caso de éxito, la respuesta tendrá el código de estado 200 y contendrá los siguientes datos:
{
  "id": "string",
  "cupo": 0,
  "cupoDisponible": 0,
  "status": "string"
}

Donde:

  • id: NIT o número de identificación del usuario.
  • cupo: Cupo del usuario.
  • cupoDisponible: Cupo disponible del usuario.
  • status: Estado del cupo.

Ejemplos de uso #

Python #

import requests

url = "https://api.leancore.co/get-user-quota"
headers = {
    "Authorization": "Bearer <token>"
}
params = {
    "nit": "1007240430"
}

response = requests.get(url, headers=headers, params=params)

if response.status_code == 200:
    user = response.json()
    print("Cupo encontrado:")
    print(user)
else:
    print("Error al consultar el cupo del usuario. Código de respuesta:", response.status_code)
    print("Mensaje de error:", response.text)