Domains

Información de un dominio

Este es el endpoint principal, donde se comprueba si un dominio está o no en la base de datos. Si la petición se hace con una clave de acceso, este responderá con más información.

Obtener información sobre un dominio en la base de datos

Obtener información sobre un dominio en la base de datos dado su nombre

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

Query parameters

Response

200207400403404500

Dominio aprobado obtenido

Body

application/json

statusstring

Estado de la petición (200)

dataobject

Información del dominio

Request

JavaScriptCurl

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

Response

{
  "status": "text",
  "data": {
    "domain": "text",
    "category": "text",
    "notes": "text",
    "submitted_by": "text",
    "submitted_at": "text"
  }
}

Añadir un dominio

Añadir un dominio a la base de datos, que luego será revisado por un moderador del servicio para posteriormente ser aprobado o denegado. Si es aprobado, el dominio estará disponible en el endpoint principal.

Añadir un dominio a la base de datos (pendiente de aprobación)

Añadir un dominio a la base de datos para que sea aprobado por un moderador

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

Body

application/json

Datos del dominio a añadir

domain*string

Dominio

categorystring

Categoría del dominio

priorityinteger

Prioridad del dominio, en base a como de peligroso puede ser para un usuario normal

notesstring

Notas sobre el dominio

submitted_by*string

Nombre del usuario que ha añadido el dominio

reason*string

Razón dada por el usuario por la que se ha añadido el dominio

Response

200400403404409500

Dominio añadido

Body

application/json

statusstring

Estado de la petición (200)

dataobject

Dominio añadido

Request

JavaScriptCurl

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

Response

{
  "status": "text",
  "data": {
    "domain": "text",
    "category": "text",
    "notes": "text",
    "submitted_by": "text",
    "submitted_at": "text"
  }
}

Modificar un dominio

Hacer modificaciones a un dominio en la base de datos. Todos los campos son opcionales y se puede hacer una petición solo con los campos a cambiar.

Este endpoint solo puede ser usado por moderadores con una clave de acceso valida.

Modificar un dominio de la base de datos

Modificar un dominio de la base de datos con su ID de dominio

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

Authorization

masterAuth

Path parameters

id*integer

ID del dominio a modificar

Body

application/json

Datos del dominio a modificar

categorystring

Categoría del dominio

priorityinteger

Prioridad del dominio, en base a como de peligroso puede ser para un usuario normal

public_notesstring

Notas públicas sobre el dominio

submitted_bystring

Nombre del usuario que ha añadido el dominio

submitted_reasonstring

Razón dada por el usuario por la que se ha añadido el dominio

approved_bynullable string

Nombre del usuario que ha aprobado el dominio

notesstring

Notas sobre el dominio

times_consultedinteger

Veces que se ha consultado el dominio

Response

200400401403404500

Dominio modificado

Body

application/json

statusstring

Estado de la petición (200)

dataobject

Dominio modificado

Request

JavaScriptCurl

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

Response

{
  "status": "text",
  "data": {
    "category": "text",
    "public_notes": "text",
    "submitted_by": "text",
    "submitted_reason": "text",
    "approved_by": "text",
    "approved_at": "text",
    "approved_key": "text",
    "notes": "text"
  }
}

Eliminar un dominio

Borrar un dominio de la base de datos de manera permanente.

Este endpoint solo puede ser usado por moderadores con una clave de acceso valida.

Eliminar un dominio de la base de datos

Eliminar un dominio de la base de datos con su ID de dominio

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

Authorization

masterAuth

Path parameters

id*integer

ID del dominio a eliminar

Response

200401403404500

Dominio eliminado

Body

application/json

statusstring

Estado de la petición (200)

dataobject

Dominio eliminado

Request

JavaScriptCurl

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

Response

{
  "status": "text",
  "data": {
    "domain": "text",
    "category": "text",
    "public_notes": "text",
    "submitted_by": "text",
    "submitted_at": "text",
    "submitted_reason": "text",
    "approved_by": "text",
    "approved_at": "text",
    "notes": "text"
  }
}