За разработчици

API, команден ред и Terraform

Управлявайте сървърите, домейните, DNS записите и функциите си от код. Повечето действия в панела могат да се извършват и през REST API с личен API ключ.

1. Създайте API ключ

Създайте ключ от страницата „API ключове“ в панела. Ключът е свързан с един акаунт и няма повече права от вашата роля в него; може да бъде само за четене, ограничен до определени продукти и с дата на изтичане. Ключът се показва изцяло само веднъж, при създаването.

Към API ключовете →

2. Първата ви заявка

Изпратете ключа в заглавката Authorization:

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

Какво е добре да знаете

Ключовете само за четене могат да правят само заявки за четене и в акаунта се държат като роля само за четене.
Ключ със запис работи с текущата роля на създателя си; ако той бъде премахнат от акаунта, ключът веднага става невалиден.
С ключ не може да се създава друг ключ; действията с екипа и поканите се извършват само от панела.
Отговорите с грешка съдържат полетата error.code и error.message.
За всеки ключ са позволени най-много 300 заявки в минута; при превишаване се връща 429 със заглавка Retry-After.

Инструмент за команден ред: v360Подготвя се за издаване

Инструмент на Node.js без зависимости (Node 18 и по-нова) за вход, списък със сървъри и управление на захранването, DNS записи и публикуване на функции.

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

Terraform доставчикПодготвя се за издаване

Ресурси за сървър, управлявана база данни, функция без сървър и DNS запис. Ресурсите за сървър и база данни създават поръчка; услугата се подготвя след плащане на фактурата.

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")
}

Инструментът за команден ред и Terraform доставчикът все още не са публикувани в npm и Terraform Registry. Дотогава можете да използвате REST API директно.

API справочник

Този списък се генерира от документа OpenAPI 3.1. За да генерирате клиент с Postman, Insomnia или openapi-generator, изтеглете документа.

Изтегли openapi.json

API документацията се зарежда…