API, ligne de commande et Terraform

1. Créez une clé API

Créez une clé depuis la page Clés API du panneau. Une clé est liée à un seul compte et ne confère jamais plus de droits que votre rôle dans ce compte ; elle peut être limitée à la lecture seule, restreinte à certains produits et dotée d'une date d'expiration. La clé complète n'est affichée qu'une seule fois, lors de sa création.

2. Votre première requête

Envoyez la clé dans l'en-tête Authorization :

curl -H "Authorization: Bearer v360_..." \
  https://api.haizora.com/v1/portal/servers

À savoir

• Les clés en lecture seule ne peuvent effectuer que des requêtes de lecture et se comportent comme un rôle en lecture seule sur le compte.
• Une clé en écriture fonctionne avec le rôle actuel de son créateur ; si la personne est retirée du compte, la clé devient immédiatement invalide.
• Une clé ne permet pas de créer d'autres clés ; les actions d'équipe et d'invitation ne peuvent être effectuées que depuis le panneau.
• Les réponses d'erreur contiennent les champs error.code et error.message.
• Chaque clé peut effectuer au maximum 300 requêtes par minute ; en cas de dépassement, une réponse 429 avec un en-tête Retry-After est renvoyée.

Outil en ligne de commande : v360Publication en préparation

Un outil Node.js sans dépendances pour la connexion, la liste des serveurs et les actions d'alimentation, les enregistrements DNS et la publication de fonctions (Node 18 et supérieur).

v360 login                      # paste a v360_... token
v360 servers list
v360 servers power <id> reboot
v360 dns list example.com
v360 dns add example.com A www 203.0.113.10 --ttl 300
v360 workers deploy ./worker.js --name hello

Fournisseur TerraformPublication en préparation

Ressources pour les serveurs, les bases de données gérées, les fonctions serverless et les enregistrements DNS. Les ressources serveur et base de données créent des commandes ; le service est mis en place une fois la facture payée.

provider "vadi360" {}   # VADI360_TOKEN

resource "vadi360_dns_record" "www" {
  domain_id = data.vadi360_domain.main.id
  type      = "A"
  name      = "www"
  value     = "203.0.113.10"
}

resource "vadi360_function" "hello" {
  name = "hello"
  code = file("worker.js")
}

L'outil en ligne de commande et le fournisseur Terraform ne sont pas encore publiés sur npm ni sur Terraform Registry. D'ici là, vous pouvez utiliser directement l'API REST.

Référence de l'API

Cette liste est générée à partir du document OpenAPI 3.1. Vous pouvez télécharger le document pour générer un client avec Postman, Insomnia ou openapi-generator.