Lee tus máquinas, ganancias, facturas y un resumen desde tus propias herramientas con una clave de solo lectura. Cómo crearla, usarla y revocarla.
Avanzado
La API para propietarios permite que tus propias herramientas lean las cifras que ves en tu portal: una hoja de cálculo, un script, un panel en tu casa. Es de solo lectura. Una clave puede ver tus datos. No puede cambiar un ajuste, una dirección de pago ni una factura.
Qué te entrega
Endpoint
Qué devuelve
machines
Tus máquinas y su estado actual
earnings
El bitcoin que han ganado tus máquinas
invoices
Tus facturas e informes mensuales
summary
Las cifras principales de tu cuenta en una sola llamada
La dirección exacta de cada endpoint, los campos de cada respuesta y los límites están en la página Desarrolladores. Esa página es la referencia. Esta guía muestra la forma de trabajar.
Crea una clave nueva y ponle un nombre que diga dónde se va a usar, como el nombre de tu hoja de cálculo.
Copia la clave de inmediato y guárdala en un gestor de contraseñas.
Usa una clave por herramienta. Si dejas de usar una herramienta o su clave se filtra, revocas solo esa clave.
Atención: Trata una clave como una contraseña. Quien la tenga puede leer tus máquinas, ganancias y facturas. Nunca la pegues en un chat, un correo, una captura de pantalla ni un documento compartido.
Una primera llamada con curl
curl es un programa pequeño, ya incluido en Mac y Linux y en las versiones recientes de Windows, que trae una dirección desde la línea de comandos. Una llamada envía tu clave en un encabezado y recibe tus datos como texto. Tiene esta forma:
ENCABEZADO_DE_CLAVE, TU_CLAVE y DIRECCION_DE_LA_API son marcadores. La página Desarrolladores da el encabezado y la dirección exactos, con un ejemplo que puedes copiar: pega tu clave en él y ejecútalo. Cambia la última palabra por machines, earnings o invoices para llamar a los otros endpoints.
Google Sheets y Zapier, por consulta periódica
La API responde cuando se le pregunta. No te envía los cambios por su cuenta. Para mantener una herramienta al día, haz que pregunte con un horario. A esto se le llama polling, o consulta periódica.
Google Sheets: escribe un Apps Script corto que consulte un endpoint con tu clave y escriba la respuesta en una hoja, y agrega un activador por tiempo para que corra cada hora o cada día.
Zapier: usa un disparador programado seguido de un paso de solicitud web que llame al endpoint con tu clave en el encabezado. Envía el resultado a una hoja, un correo o un mensaje de chat.
Tu propio script: sirve cualquier lenguaje que pueda hacer una solicitud web. Ejecútalo con un horario.
Bueno saberlo: No preguntes más seguido de lo que cambian las cifras. El hashrate se mueve cada pocos minutos, las ganancias una vez al día, las facturas una vez al mes. Para la mayoría de los usos, una vez por hora es suficiente.
Cuida la clave
Guárdala en el campo de secretos o credenciales de la herramienta, no en una celda ni en el código mismo.
No compartas una hoja ni un zap que muestre la clave.
A tu contador dale un archivo o una clave propia, no la tuya.
Revisa de vez en cuando la lista en Claves de API y elimina las claves que ya no usas.