Blacklist

Obtener todos los usuarios

Este endpoint solo puede ser usado por administradores con una clave de acceso maestra.

Obtener todos los usuarios que han sido vetados del servicio.

Obtener la lista negra

get

Obtener la lista negra de usuarios que han sido vetados del uso de la base de datos

Autorizaciones

masterAuth

AuthorizationstringRequerido

Token de autenticación de administrador, solo para uso interno

Respuestas

200

Lista negra obtenida

application/json

401

No autorizado

application/json

500

Error interno del servidor

application/json

get

/blacklist

HTTPcURLJavaScriptPython

GET /api/blacklist HTTP/1.1
Host: phishing.lacabra.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "text",
  "data": [
    {
      "ip": "text",
      "reason": "text",
      "date": "text"
    }
  ]
}

O obtener la información específica de un usuario

Obtener un veto de la lista negra

get

Obtener un veto de la lista negra con la IP del usuario

Autorizaciones

masterAuth

AuthorizationstringRequerido

Token de autenticación de administrador, solo para uso interno

Parámetros de ruta

ipstringRequerido

IP del usuario a obtener

Respuestas

200

Veto obtenido

application/json

401

No autorizado

application/json

404

Veto no encontrado

application/json

500

Error interno del servidor

application/json

get

/blacklist/{ip}

HTTPcURLJavaScriptPython

GET /api/blacklist/{ip} HTTP/1.1
Host: phishing.lacabra.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "text",
  "data": {
    "ip": "text",
    "reason": "text",
    "expires_at": "text",
    "created_at": "text",
    "created_by": "text",
    "notes": "text"
  }
}

Añadir usuario a la lista

Este endpoint solo puede ser usado por administradores con una clave de acceso maestra.

Añadir manualmente un usuario por su IP a la lista de usuarios vetados.

Añadir a la lista negra

post

Añadir a la lista negra un usuario con su IP

Autorizaciones

masterAuth

AuthorizationstringRequerido

Token de autenticación de administrador, solo para uso interno

Cuerpo

application/json

ipstringRequerido

IP del usuario

reasonstringOpcional

Razón del veto

expires_atstringOpcional

Fecha de expiración del veto, en formato RFC 3339

created_bystringOpcional

Nombre del usuario que ha añadido al usuario a la lista negra

notesstringOpcional

Notas sobre el veto

Respuestas

200

Usuario añadido a la lista negra

application/json

Respuestaobject

400

Petición incorrecta o vacía

application/json

401

No autorizado

application/json

409

El usuario ya está en la lista negra

application/json

500

Error interno del servidor

application/json

post

/blacklist

HTTPcURLJavaScriptPython

POST /api/blacklist HTTP/1.1
Host: phishing.lacabra.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 84

{
  "ip": "text",
  "reason": "text",
  "expires_at": "text",
  "created_by": "text",
  "notes": "text"
}

{}

Eliminar un usuario de la lista

Este endpoint solo puede ser usado por administradores con una clave de acceso maestra.

Borrar un usuario de la lista negra, esto permitirá que el usuario vuelva a usar el servicio pero podrá volver a ser baneado en un futuro.

Eliminar un veto de la lista negra

delete

Eliminar un veto de la lista negra con su ID de veto

Autorizaciones

masterAuth

AuthorizationstringRequerido

Token de autenticación de administrador, solo para uso interno

Parámetros de ruta

ipstringRequerido

IP del usuario a eliminar

Respuestas

200

Veto eliminado

application/json

400

Petición incorrecta o vacía

application/json

401

No autorizado

application/json

404

Veto no encontrado

application/json

500

Error interno del servidor

application/json

delete

/blacklist

HTTPcURLJavaScriptPython

DELETE /api/blacklist HTTP/1.1
Host: phishing.lacabra.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

Sin contenido

Modificar un usuario de la lista

Este endpoint solo puede ser usado por administradores con una clave de acceso maestra.

Modificar información de un veto del servicio.

Modificar un veto de la lista negra

patch

Modificar un veto de la lista negra con su ID de veto

Autorizaciones

masterAuth

AuthorizationstringRequerido

Token de autenticación de administrador, solo para uso interno

Parámetros de ruta

ipstringRequerido

IP del usuario a modificar

Cuerpo

application/json

reasonstringOpcional

Razón del veto

expires_atstringOpcional

Fecha de expiración del veto, en formato RFC 3339

created_bystringOpcional

Nombre del usuario que ha añadido al usuario a la lista negra

notesstringOpcional

Notas sobre el veto

Respuestas

200

Veto modificado

application/json

400

Petición incorrecta o vacía

application/json

401

No autorizado

application/json

404

Veto no encontrado

application/json

500

Error interno del servidor

application/json

patch

/blacklist

HTTPcURLJavaScriptPython

PATCH /api/blacklist HTTP/1.1
Host: phishing.lacabra.app
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 72

{
  "reason": "text",
  "expires_at": "text",
  "created_by": "text",
  "notes": "text"
}

Sin contenido

Comprobar si he sido baneado

Este endpoint se usa para verificar si la IP del usuario que ha hecho el request está en la lista negra o no, devolviendo información del veto en caso de existir.

Comprobar si la IP del usuario que ha hecho la petición está en la lista negra

get

Comprobar si tu IP está en la lista negra

Respuestas

200

Usuario en la lista negra

application/json

404

Usuario no encontrado en la lista negra

application/json

500

Error interno del servidor

application/json

get

/blacklist/check

HTTPcURLJavaScriptPython

GET /api/blacklist/check HTTP/1.1
Host: phishing.lacabra.app
Accept: */*

{
  "status": "text",
  "data": {
    "ip": "text",
    "reason": "text",
    "expires_at": "text",
    "created_at": "text",
    "created_by": "text",
    "notes": "text"
  }
}