Generalidades
Una interfaz de programación de aplicaciones (API) es una interfaz de software creada para una plataforma de software específica. Esta interfaz permite que el software externo (como un programa que hayas creado) o una URL que visite en un navegador interactúe con la plataforma de software principal.
DreamHost ofrece una API que los clientes pueden usar para interactuar con la información de su cuenta, como dominios, DNS, correo, bases de datos y usuarios.
La API de DreamHost ofrece actualmente los siguientes tres comandos.
Se han eliminado los comandos de API anteriormente disponibles para administrar tu cuenta, dominio, correo, bases de datos, recompensas y usuarios.
Conectar con la API
¿Cómo conectarme a una API de DreamHost?
Puedes conectarte a la API de DreamHost de dos formas:
- Visitando la URL en tu buscador
- Escribiendo un script
En ambos casos, los resultados se devuelven en el formato que elijas. Los formatos válidos son:
Revisa el siguiente artículo para obtener instrucciones sobre cómo conectarte a la API de DreamHost:
Implementación de notas
Sensibilidad a mayúsculas y minúsculas
Todos los nombres de parameter distinguen entre mayúsculas y minúsculas y deben estar en minúsculas. sin embargo, los values que envías al servidor generalmente no distingue entre mayúsculas y minúsculas.
Limitación de Rango
Para garantizar que los sistemas DreamHost permanezcan estables y con capacidad de respuesta, la velocidad a la que el mismo usuario puede ejecutar ciertos comandos de API o grupos de comandos de API es limitada.
Estos límites son relativamente generosos y muy pocos usuarios se topan con ellos. Los límites generalmente se establecen por hora o por día, aunque algunos comandos pueden tener límites en períodos de tiempo más cortos, como 10 minutos.
Cuando las llamadas a la API fallan por cualquier motivo (por ejemplo, si intentaste crear un usuario que ya existía), no cuenta para tus límites (ten en cuenta que esto también significa que fallar porque excediste el límite de frecuencia también no cuenta).
Cuando te encuentras con un límite, el error que devuelve es:
error slow_down_bucko (información detallada sobre el tipo de límite alcanzado después de una pestaña)
Si te encuentras con este error, debes considerar las formas en las que podrías reducir la frecuencia con la que llama al API. Lo más probable es que solo te encuentres con estos límites si tienes un script o un programa automatizado que se repite para realizar llamadas al API repetidamente. Por lo tanto, simplemente puedes reducir la velocidad a la que se ejecuta tu script o asegurarte de que haces un seguimiento de cuántos comandos ha emitido en la última hora/día.
Cuenta de Prueba
Si deseas probar la API de DreamHost sin tener tu propia cuenta, puedes utilizar la siguiente clave de API:
6SHU5P2HLDAYECUM
Esta cuanta solo tiene acceso a los comandos de "list". Por ejemplo:
https://api.dreamhost.com/?key=6SHU5P2HLDAYECUM&cmd=dns-list_records