Uso do cURL

6.4.1 Introdução

Utilitário de linha de comando para enviar requisições HTTP. Disponível em qualquer computador sem instalação adicional: integrado no macOS e Linux, disponível no Windows a partir do Windows 10.

6.4.2 Instalação

Windows

curl está integrado no Windows 10 e versões mais recentes. Para verificar a presença:

curl --version

Se o curl não estiver instalado — baixe em curl.se/download.html.

macOS

curl está integrado por padrão. Para verificar a versão:

curl --version

Linux

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

6.4.3 Estrutura do Comando

Sintaxe básica de uma requisição com bearer-token: ⚠️ Este é um exemplo (sintaxe Linux/macOS). No Windows, os caracteres de quebra de linha e de escape de aspas são diferentes.

curl -X <MÉTODO> http://<IP_do_minerador>/api/v1/<endpoint> \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <token>" \ 
  -H "x-api-key: <chave>" \
  -H "Content-Type: application/json" \
  -d '<corpo_da_requisição>'

A autorização é uma das duas opções: Authorization: Bearer <token> (obtido via POST /unlock) ou x-api-key: <chave> (criado via POST /apikeys). O cabeçalho x-api-key é especificado separadamente, e não dentro de Authorization. Flags principais:

• -X — método da requisição: GET, PUT, POST, DELETE
• -H — cabeçalho da requisição, por exemplo, tipo de conteúdo ou token de autorização
• -d — corpo da requisição no formato JSON (para PUT e POST) Se forem necessárias funcionalidades adicionais, a lista completa de flags pode ser consultada na documentação oficial do curl: man curl ou em curl.se/docs.

6.4.4 Início Rápido

Exemplo: obter um bearer-token e usá-lo imediatamente na próxima requisição.

Passo 1. Obter o token

curl -X POST http://<IP_do_minerador>/api/v1/unlock -H"Content-Type: application/json" -d'{"pw": "senha_do_dispositivo"}'

⚠️ Este é um exemplo (sintaxe Linux/macOS). Para o Windows CMD, é necessário substituir as aspas simples por aspas duplas com escape: -d "{\"pw\": \"senha_do_dispositivo\"}" Resposta do servidor 200 (OK):

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

Passo 2. Usar o token na requisição

Copie o valor de token da resposta e insira-o no cabeçalho Authorization da próxima requisição:

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