Keys

Obtener información de una clave

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

Obtener toda la información de una clave existente.

Obtener información sobre una clave de acceso

get

Obtener información sobre una clave de acceso dada su clave

Autorizaciones

masterAuth

AuthorizationstringRequerido

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

Parámetros de consulta

keystringRequerido

Clave de acceso a obtener

Respuestas

200

Clave obtenida

application/json

400

Petición incorrecta o vacía

application/json

401

No autorizado

application/json

404

Clave no encontrada

application/json

500

Error interno del servidor

application/json

get

/keys

HTTPcURLJavaScriptPython

GET /api/keys?key=text HTTP/1.1
Host: phishing.lacabra.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "status": "text",
  "data": {
    "key": "text",
    "created_at": "text",
    "expires_at": 1,
    "last_used_at": "text",
    "owner": "text",
    "uses": 1,
    "ips": [
      "text"
    ],
    "user_agent": "text",
    "created_by": "text",
    "notes": "text"
  }
}

Crear una clave de acceso

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

Crear una clave de acceso para un nuevo moderador del servicio

Añadir una clave de acceso

post

Añadir una clave de acceso

Autorizaciones

masterAuth

AuthorizationstringRequerido

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

Cuerpo

application/json

expires_atstringRequerido

Fecha de expiración de la clave, en formato RFC 3339. Máximo 5 año

ownerstringRequerido

Nombre del usuario dueño de la clave

created_byintegerRequerido

Nombre del usuario que ha creado la clave

notesstringOpcional

Notas sobre la clave

Respuestas

200

Clave añadida

application/json

400

Petición incorrecta o vacía

application/json

401

No autorizado

application/json

500

Error interno del servidor

application/json

post

/keys

HTTPcURLJavaScriptPython

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

{
  "expires_at": "text",
  "owner": "text",
  "created_by": 1,
  "notes": "text"
}

{
  "status": "text",
  "data": {
    "key": "text",
    "created_at": "text",
    "expires_at": 1,
    "owner": "text",
    "created_by": "text",
    "notes": "text"
  }
}

Borrar una clave de acceso

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

Borrar permanentemente una clave de acceso de un moderador del servicio.

Eliminar una clave de acceso

delete

Eliminar una clave de acceso con su clave

Autorizaciones

masterAuth

AuthorizationstringRequerido

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

Parámetros de ruta

keystringRequerido

Clave de acceso a eliminar

Respuestas

200

Clave eliminada

application/json

400

Petición incorrecta o vacía

application/json

401

No autorizado

application/json

404

Clave no encontrada

application/json

500

Error interno del servidor

application/json

delete

/keys

HTTPcURLJavaScriptPython

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

{
  "status": "text",
  "data": {
    "key": "text",
    "created_at": "text",
    "expires_at": 1,
    "last_used_at": "text",
    "owner": "text",
    "uses": 1,
    "ips": [
      "text"
    ],
    "user_agent": "text",
    "created_by": "text",
    "notes": "text"
  }
}

Modificar una clave de acceso

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

Modificar información de una clave existente.

Modificar una clave de acceso

patch

Modificar una clave de acceso con su clave

Autorizaciones

masterAuth

AuthorizationstringRequerido

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

Parámetros de ruta

keystringRequerido

Clave de acceso a modificar

Cuerpo

application/json

expires_atstringOpcional

Fecha de expiración de la clave, en formato RFC 3339. Máximo 5 año

last_used_atintegerOpcional

Fecha de la última vez que se ha usado la clave, en formato RFC 3339

ownerstringOpcional

Nombre del usuario dueño de la clave

usesintegerOpcional

Veces que se ha usado la clave

ipsstring[]Opcional

IPs desde las que se ha usado la clave

user_agentstringOpcional

User-Agent desde el que se ha usado la clave por última vez

created_bystringOpcional

Nombre del usuario que ha creado la clave

notesintegerOpcional

Notas sobre la clave

Respuestas

200

Clave modificada

application/json

400

Petición incorrecta o vacía

application/json

401

No autorizado

application/json

404

Clave no encontrada

application/json

500

Error interno del servidor

application/json

patch

/keys

HTTPcURLJavaScriptPython

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

{
  "expires_at": "text",
  "last_used_at": 1,
  "owner": "text",
  "uses": 1,
  "ips": [
    "text"
  ],
  "user_agent": "text",
  "created_by": "text",
  "notes": 1
}

{
  "status": "text",
  "data": {
    "expires_at": "text",
    "last_used_at": 1,
    "owner": "text",
    "uses": 1,
    "ips": [
      "text"
    ],
    "user_agent": "text",
    "created_by": "text",
    "notes": 1
  }
}