Documentación API de DockerLabs

Esta página proporciona ejemplos de cómo usar la API de DockerLabs con curl.

1. Obtener un Token Temporal

Para obtener un token temporal, utiliza el siguiente comando curl. Esto solo está disponible para los administradores de dockerlabs.

curl -u usuario:contraseña https://dockerlabs.es/get_token

Nota: El token es válido por 1 hora y se requiere para acceder a algunos endpoints.

2. Subir Writeups

Para subir un writeup, utiliza el siguiente comando curl (no requiere autenticación):

curl -X POST -H "Content-Type: application/json" -d '{
    "maquina": "Maquina1",
    "autor": "Autor1",
    "url": "http://example.com",
    "tipo": "texto"
}' https://dockerlabs.es/subirwriteups

3. Añadir Writeup (con Token)

Para procesar writeups y actualizar el ranking, utiliza el siguiente comando curl:

curl -X POST -H "Content-Type: application/json" -d '{}' \
https://dockerlabs.es/addwriteup?token=generated_token_here

4. Ver Writeups (con Token)

Para ver los writeups almacenados, utiliza el siguiente comando curl:

curl https://dockerlabs.es/verwriteups?token=generated_token_here

5. Añadir Máquina (con Token)

Para añadir una nueva máquina, utiliza el siguiente comando curl:

curl -X POST -H "Content-Type: application/json" -d '{
    "nombre": "Maquina2",
    "dificultad": "medio",
    "autor": "Autor2",
    "enlace_autor": "http://example.com/autor2",
    "fecha": "2023-10-01",
    "tamaño": "1GB",
    "link_descarga": "http://example.com/download",
    "posicion": "izquierda",
    "descripcion": "Descripción de la máquina"
}' https://dockerlabs.es/addmaquina?token=generated_token_here

6. Obtener Datos de la API

Para obtener datos generales de la API, lo cual es ideal para tareas de web scraping, utiliza el siguiente comando curl:

curl https://dockerlabs.es/api

Nota: Dentro del endpoint /api, también se ofrece información detallada sobre cada máquina disponible en la plataforma. Esto incluye datos como la dificultad, el autor, el enlace del autor, la fecha de publicación, el tamaño del archivo, el enlace de descarga, la posición y una descripción de la máquina.

Notas Adicionales

Importante: Los endpoints para subir writeups y para obtener todos los writeups y máquinas no requieren autenticación con el token temporal. Los endpoints para añadir máquinas o actualizar los rankings, solamente son accesibles por los administradores de DockerLabs (Mario).