Uso de cURL

6.4.1 Introducción

Utilidad de línea de comandos para enviar solicitudes HTTP. Disponible en cualquier ordenador sin instalación adicional: integrada en macOS y Linux, disponible en Windows a partir de Windows 10.

6.4.2 Instalación

Windows

curl está integrado en Windows 10 y versiones posteriores. Verificar su presencia:

curl --version

Si curl no está instalado, descárguelo desde curl.se/download.html.

macOS

curl está integrado por defecto. Verificar la versión:

curl --version

Linux

sudo apt install curl      # Ubuntu/Debian
sudo yum install curl      # CentOS/RHEL

6.4.3 Estructura del comando

Sintaxis básica de una solicitud con un token bearer: ⚠️ Este es un ejemplo (sintaxis de Linux/macOS). En Windows, los caracteres de salto de línea y el escape de comillas son diferentes.

curl -X <MÉTODO> http://<IP_del_minero>/api/v1/<endpoint> \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <token>" \
  -H "x-api-key: <clave>" \
  -H "Content-Type: application/json" \
  -d '<cuerpo_de_la_solicitud>'

La autorización es una de dos: Authorization: Bearer <token> (obtenido a través de POST /unlock) o bien x-api-key: <clave> (creado a través de POST /apikeys). El encabezado x-api-key se especifica por separado, no dentro de Authorization. Banderas principales:

• -X — método de solicitud: GET, PUT, POST, DELETE
• -H — encabezado de la solicitud, por ejemplo, el tipo de contenido o el token de autorización
• -d — cuerpo de la solicitud en formato JSON (para PUT y POST) Si necesita funcionalidades adicionales, la lista completa de banderas se puede consultar en la documentación oficial de curl: man curl o en curl.se/docs.

6.4.4 Inicio rápido

Ejemplo: obtener un token bearer y usarlo inmediatamente en la siguiente solicitud.

Paso 1. Obtener el token

curl -X POST http://<IP_del_minero>/api/v1/unlock -H"Content-Type: application/json" -d'{"pw": "contraseña_del_dispositivo"}'

⚠️ Este es un ejemplo (sintaxis de Linux/macOS). Para Windows CMD es necesario reemplazar las comillas simples por dobles con escape: -d "{\"pw\": \"contraseña_del_dispositivo\"}" Respuesta del servidor 200 (OK):

{"token":"eyJhbGciOiJIUzI1NiIs..."}

Paso 2. Usar el token en la solicitud

Copie el valor de token de la respuesta e insértelo en el encabezado Authorization de la siguiente solicitud:

curl -X GET https://<IP_del_minero>/api/v1/status -H "Accept: application/json" -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."