---
title: "Cómo crear una clave de API y administrar tu servidor con la API del panel"
description: "Crea una clave de API en tu cuenta del panel y úsala para encender, apagar y reiniciar el servidor, enviar comandos y manejar archivos desde un script. Función experimental, sin soporte del equipo."
url: "https://redhosting.com.br/es/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel"
type: "article"
language: "es"
category: "Otros"
published: "2026-09-24"
translations:
  pt-BR: "https://redhosting.com.br/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel.md"
  en: "https://redhosting.com.br/en/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel.md"
  es: "https://redhosting.com.br/es/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel.md"
  de: "https://redhosting.com.br/de/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel.md"
---

# Cómo crear una clave de API y administrar tu servidor con la API del panel

Crea una clave de API en tu cuenta del panel y úsala para encender, apagar y reiniciar el servidor, enviar comandos y manejar archivos desde un script. Función experimental, sin soporte del equipo.

- Guía de la base de conocimiento de RedHosting — categoría: Otros
- Página HTML: https://redhosting.com.br/es/base-de-conhecimento/como-criar-uma-chave-de-api-e-gerenciar-seu-servidor-pela-api-do-painel
- Publicado el: 2026-09-24 · Idioma: es

🧪**Función experimental, sin soporte**: La API del panel está disponible para quien quiera automatizar su propio servidor, pero **RedHosting no ofrece soporte para ella**. El equipo no ayuda a armar scripts, no depura integraciones y no responde por lo que un script ejecute en tu servidor, incluido apagarlo, borrar archivos o enviar comandos por error. El comportamiento de la API puede cambiar sin aviso. El soporte sigue cubriendo el servicio en sí: servidor caído, panel, red y facturación.

Todo lo que haces con clics en el panel (encender el servidor, enviar un comando a la consola, editar un archivo) también se puede hacer con una solicitud HTTP. Es lo que permite que un bot de Discord reinicie el servidor de Minecraft con un comando, que un script vuelva a encender el servidor si se cae o que una rutina guarde un archivo de configuración cada día.

Esta guía muestra cómo crear la clave que da ese acceso y cómo usarla en las operaciones más comunes.

## 1. Qué puede hacer la clave de API

La clave actúa **en nombre de tu cuenta**. No tiene permisos separados: lo que tú puedes hacer en el panel, ella también puede, en **todos los servidores de la cuenta**. Las operaciones más usadas son:

- **Energía**: encender, apagar, reiniciar y forzar el apagado.
- **Consola**: enviar comandos como `say`, `whitelist add` o `save-all`.
- **Consumo**: leer el estado del servidor y el uso de CPU, memoria y disco.
- **Archivos**: listar carpetas, leer y escribir archivos.
- **Copias de seguridad y tareas programadas**: las mismas que aparecen en las pestañas del servidor.

  ⚠️**Trata la clave como tu contraseña**: Quien tenga la clave controla todos tus servidores, sin necesitar la contraseña ni la verificación en dos pasos. Nunca publiques la clave en GitHub, en una captura o en un canal de Discord.

## 2. Crear la clave

El panel puede mostrar las etiquetas en portugués; el nombre original va entre paréntesis.

1. Entra al panel en [app.redhosting.com.br](https://app.redhosting.com.br).
2. En el menú lateral, haz clic en **Cuenta** (Conta), o abre directamente [app.redhosting.com.br/account](https://app.redhosting.com.br/account).
3. Baja hasta el recuadro de claves, al final de la página, y haz clic en la pestaña **Clave API** (Chave API); la pestaña de al lado es la de clave SSH.
4. En **Descripción** (Descrição), escribe para qué sirve la clave, por ejemplo `bot de discord`. Son al menos 4 caracteres, y es ese nombre el que te dirá, meses después, qué clave borrar.
5. En **IP permitidas** (IPs Permitidos), pon la IP de la máquina que usará la clave, una por línea. Dejarlo en blanco permite usarla desde cualquier lugar de internet.
6. Haz clic en **Crear** (Criar).

La ventana **Tu clave API** (Sua Chave API) muestra la clave completa, que empieza con `ptlc_`. Cópiala y guárdala en un lugar seguro: **no se vuelve a mostrar**. Si la pierdes, borra la clave y crea otra.

  💡**Consejo**: Si el script va a correr en una VPS o en un servidor de bot de RedHosting, rellena IP permitidas con su IP. Así, aunque la clave se filtre, no funcionará desde ningún otro lugar.

## 3. Encontrar el identificador del servidor

Cada llamada tiene que indicar en qué servidor actuar. El identificador aparece en la barra de direcciones cuando abres el servidor en el panel:

```
https://app.redhosting.com.br/server/1a2b3c4d
```

El identificador es la parte después de `/server/`; en el ejemplo, `1a2b3c4d`. Los ejemplos de abajo usan `TU_SERVIDOR` en su lugar y `TU_CLAVE` en lugar de la clave.

## 4. Primera prueba

Cada solicitud lleva la clave y la indicación de que la conversación es en JSON. Este comando lista los servidores de la cuenta y confirma que la clave funciona:

```
curl https://app.redhosting.com.br/api/client \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Accept: application/json"
```

La respuesta trae un elemento por servidor. El campo `identifier` de cada uno es el mismo identificador del paso anterior.

## 5. Administrar el servidor

### Ver si está encendido y cuánto consume

```
curl https://app.redhosting.com.br/api/client/servers/TU_SERVIDOR/resources \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Accept: application/json"
```

El campo `current_state` indica el estado: `running`, `starting`, `stopping` u `offline`. En `resources` vienen la memoria y el disco en bytes y la CPU en porcentaje.

### Encender, apagar y reiniciar

```
curl -X POST https://app.redhosting.com.br/api/client/servers/TU_SERVIDOR/power \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"signal": "restart"}'
```

El `signal` acepta `start`, `stop`, `restart` y `kill`. Prefiere `stop`: apaga con calma y deja que el servidor guarde lo que está en memoria. `kill` corta en el acto, como desenchufar, y puede corromper el mundo o archivos abiertos.

### Enviar un comando a la consola

```
curl -X POST https://app.redhosting.com.br/api/client/servers/TU_SERVIDOR/command \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"command": "say Reinicio en 5 minutos"}'
```

El comando llega a la consola exactamente como si lo hubieras escrito ahí. El servidor tiene que estar encendido; apagado, la respuesta es un error 502.

### Leer y escribir archivos

Para listar una carpeta:

```
curl "https://app.redhosting.com.br/api/client/servers/TU_SERVIDOR/files/list?directory=/" \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Accept: application/json"
```

Para leer un archivo (la respuesta es el contenido puro, no JSON):

```
curl "https://app.redhosting.com.br/api/client/servers/TU_SERVIDOR/files/contents?file=/server.properties" \
  -H "Authorization: Bearer TU_CLAVE"
```

Para escribir, el cuerpo de la solicitud es todo el contenido nuevo del archivo, que se reemplaza:

```
curl -X POST "https://app.redhosting.com.br/api/client/servers/TU_SERVIDOR/files/write?file=/motd.txt" \
  -H "Authorization: Bearer TU_CLAVE" \
  -H "Accept: application/json" \
  --data-binary @motd.txt
```

Resumen de las direcciones. Todas empiezan con `https://app.redhosting.com.br/api/client/servers/TU_SERVIDOR`:

    AcciónMétodoDirección

    Estado y consumoGET`/resources`
    Encender, apagar, reiniciarPOST`/power`
    Comando en la consolaPOST`/command`
    Listar carpetaGET`/files/list?directory=/`
    Leer archivoGET`/files/contents?file=/ruta`
    Escribir archivoPOST`/files/write?file=/ruta`
    Listar copias de seguridadGET`/backups`

## 6. Ejemplo: volver a encender el servidor si se cae

Un script en Node.js (versión 18 o más reciente) que comprueba el estado y enciende el servidor cuando lo encuentra apagado. La clave viene de una variable de entorno, no escrita en el código: así no termina en GitHub junto con el resto.

```
const PANEL = 'https://app.redhosting.com.br/api/client';
const SERVER = 'TU_SERVIDOR';
const headers = {
  Authorization: `Bearer ${process.env.PANEL_API_KEY}`,
  Accept: 'application/json',
  'Content-Type': 'application/json',
};

async function check() {
  const response = await fetch(`${PANEL}/servers/${SERVER}/resources`, { headers });
  if (!response.ok) throw new Error(`La API respondió ${response.status}`);

  const { attributes } = await response.json();
  if (attributes.current_state === 'offline') {
    await fetch(`${PANEL}/servers/${SERVER}/power`, {
      method: 'POST',
      headers,
      body: JSON.stringify({ signal: 'start' }),
    });
    console.log('El servidor estaba apagado: encendiéndolo.');
  }
}

check().catch((error) => console.error(error.message));
```

Ejecutado cada pocos minutos con una tarea programada del sistema, vuelve a encender el servidor tras una caída. No lo ejecutes con un intervalo demasiado corto: mira el límite de solicitudes en la siguiente sección.

  💡**Consejo**: Antes de automatizar el reencendido, descubre por qué se cae el servidor. Un servidor que se cae por falta de memoria volverá a caerse poco después de encenderse, y el script solo oculta el problema. La guía [Mi servicio está caído: cómo descubrir la causa](/es/base-de-conhecimento/meu-servico-esta-fora-do-ar-como-descobrir-a-causa) ayuda con eso.

## 7. Errores comunes

    RespuestaQué significaQué hacer

    **401**La clave no fue aceptada.Comprueba que copiaste la clave entera, con `ptlc_`, y que la cabecera es `Authorization: Bearer`. Una clave borrada en el panel deja de funcionar al instante.
    **403**La clave funciona, pero no aquí.La IP desde la que salió la solicitud no está en IP permitidas, o tu cuenta es subusuaria del servidor sin permiso para esa acción.
    **404**Servidor o archivo no encontrado.Comprueba el identificador de 8 caracteres y la ruta del archivo, que empieza con `/`.
    **409**El servidor no puede hacer eso ahora.Se está instalando, transfiriendo o está suspendido. Espera a que termine.
    **429**Demasiadas solicitudes.El panel acepta hasta 256 solicitudes por minuto por cuenta. Espacia las llamadas.
    **502**El servidor tiene que estar encendido.Ocurre al enviar un comando con el servidor apagado. Enciéndelo antes.

## 8. Seguridad

- **Una clave por uso.** Una para el bot, otra para el script de copias. Si una se filtra, borras solo esa y el resto sigue funcionando.
- **Rellena IP permitidas** siempre que sepas desde dónde se usará la clave.
- **Guarda la clave en una variable de entorno o en un archivo `.env`** que esté en el `.gitignore`, nunca dentro del código.
- **Revisa el "Último uso"** de cada clave en la pestaña Clave API. Una clave que ya no usas pero que sigue usándose es una clave filtrada.
- **Para revocar**, haz clic en la papelera junto a la clave. El borrado vale al instante para todas las solicitudes.

  Antes de poner el script en marcha

    ✓La clave tiene una descripción que dice para qué sirve.

    ✓IP permitidas está rellenado con la IP de la máquina que usará la clave.

    ✓La clave está en una variable de entorno, fuera del código y fuera de Git.

    ✓Probaste la clave con el listado de servidores y recibiste tu lista.

    ✓El script usa `stop`, y no `kill`, para apagar.

    ✓Sabes que la API es experimental y que el soporte no ayuda con el script.

## Preguntas frecuentes

**¿RedHosting da soporte a la API del panel?**

No. La API es una función experimental, ofrecida tal cual: el equipo no ayuda a armar scripts ni depura integraciones, y no responde por lo que un script ejecute en el servidor. El soporte sigue cubriendo el servicio en sí: servidor caído, panel, red y facturación.

**¿Dónde creo la clave de API?**

En el panel, en **Cuenta** (Conta) → pestaña **Clave API** (Chave API), en el recuadro del final de la página. Rellena la descripción y las IP permitidas y haz clic en Crear.

**Perdí la clave. ¿Puedo verla de nuevo?**

No. La clave solo aparece una vez, al crearla. Borra la antigua con la papelera y crea otra.

**¿A qué servidores da acceso la clave?**

A todos los servidores de tu cuenta, con los mismos permisos que tienes en el panel. No existe una clave limitada a un solo servidor; por eso conviene rellenar IP permitidas y usar una clave por aplicación.

**¿Dónde encuentro el identificador del servidor?**

En la barra de direcciones, al abrir el servidor en el panel: es el código de 8 caracteres después de `/server/`.

**¿Puedo usar la clave en un bot de Discord?**

Sí, guardando la clave en una variable de entorno y nunca en el código. Y restringe en el bot quién puede activar los comandos: un comando de apagar abierto a todo el servidor de Discord es un botón de apagar abierto a cualquiera.

**¿Hay un límite de solicitudes?**

Sí, 256 por minuto. Por encima de eso la API responde 429 hasta que cambie el minuto.

## Navegación — Otros (artículo 9 de 9)

- Artículo anterior: [Bienvenido a la documentación de RedHosting](https://redhosting.com.br/es/base-de-conhecimento/bem-vindo-ao-git-da-redhosting.md) — https://redhosting.com.br/es/base-de-conhecimento/bem-vindo-ao-git-da-redhosting
- Volver a la base de conocimiento: https://redhosting.com.br/es/base-de-conhecimento

---

¿Necesitas ayuda con este paso a paso? Soporte 24/7 de RedHosting: suporte@redhosting.com.br · WhatsApp +55 11 98833-3902 · https://redhosting.com.br/discord

Otras guías: https://redhosting.com.br/es/base-de-conhecimento.md