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

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

GEThttps://phishing.lacabra.app/api/blacklist

Authorization

masterAuth

Response

200401500

Lista negra obtenida

Body

application/json

statusstring

Estado de la petición (200)

dataarray of object

Lista negra

Request

JavaScriptCurl

const response = await fetch('https://phishing.lacabra.app/api/blacklist', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer UUID"
    },
});
const data = await response.json();

Response

{
  "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

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

GEThttps://phishing.lacabra.app/api/blacklist/{ip}

Authorization

masterAuth

Path parameters

ip*string

IP del usuario a obtener

Response

200401404500

Veto obtenido

Body

application/json

statusstring

Estado de la petición (200)

dataobject

Veto obtenido

Request

JavaScriptCurl

const response = await fetch('https://phishing.lacabra.app/api/blacklist/{ip}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer UUID"
    },
});
const data = await response.json();

Response

{
  "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

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

POSThttps://phishing.lacabra.app/api/blacklist

Authorization

masterAuth

Body

application/json

Datos del usuario a añadir

ip*string

IP del usuario

reasonstring

Razón del veto

expires_atstring

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

created_bystring

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

notesstring

Notas sobre el veto

Response

200400401409500

Usuario añadido a la lista negra

Body

application/json

object

Request

JavaScriptCurl

const response = await fetch('https://phishing.lacabra.app/api/blacklist', {
    method: 'POST',
    headers: {
      "Authorization": "Bearer UUID",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "ip": "text"
    }),
});
const data = await response.json();

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

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

DELETEhttps://phishing.lacabra.app/api/blacklist

Authorization

masterAuth

Path parameters

ip*string

IP del usuario a eliminar

Response

200400401404500

Veto eliminado

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('https://phishing.lacabra.app/api/blacklist', {
    method: 'DELETE',
    headers: {
      "Authorization": "Bearer UUID"
    },
});
const data = await response.json();

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

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

PATCHhttps://phishing.lacabra.app/api/blacklist

Authorization

masterAuth

Path parameters

ip*string

IP del usuario a modificar

Body

application/json

Datos del veto a modificar

reasonstring

Razón del veto

expires_atstring

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

created_bystring

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

notesstring

Notas sobre el veto

Response

200400401404500

Veto modificado

Body

application/json

any

Request

JavaScriptCurl

const response = await fetch('https://phishing.lacabra.app/api/blacklist', {
    method: 'PATCH',
    headers: {
      "Authorization": "Bearer UUID",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

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

Comprobar si tu IP está en la lista negra

GEThttps://phishing.lacabra.app/api/blacklist/check

Response

200404500

Usuario en la lista negra

Body

application/json

statusstring

Estado de la petición (200)

dataobject

Usuario en la lista negra

Request

JavaScriptCurl

const response = await fetch('https://phishing.lacabra.app/api/blacklist/check', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

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