پرش به مطلب اصلی

SDK زبان Go

ماژول github.com/ariaservice/arianet-go کلاینت رسمی Go برای وب سرویس‌های آریانت است. فقط از کتابخانه استاندارد Go استفاده می‌کند و به Go نسخه ۱.۲۲ یا بالاتر نیاز دارد.

نصب​

go get github.com/ariaservice/arianet-go@v0.1.0

شروع سریع​

در پنل یک توکن شخصی API بسازید و آن را export کنید:

export ARIANET_TOKEN="paste-your-token-here"
package main

import (
"context"
"fmt"
"log"

"github.com/ariaservice/arianet-go"
)

func main() {
ctx := context.Background()
client := arianet.NewClient("") // empty token: read ARIANET_TOKEN

resp, err := client.Cloud.ListServers(ctx, &arianet.CloudListServersParams{
PerPage: arianet.Int(50),
})
if err != nil {
log.Fatal(err)
}

var servers []struct {
ID int64 `json:"id"`
Name string `json:"name"`
Status string `json:"status"`
}
if err := resp.DecodeData(&servers); err != nil {
log.Fatal(err)
}
for _, s := range servers {
fmt.Println(s.ID, s.Name, s.Status)
}
}

گروه‌های API​

هر وب سرویس یک فیلد از Client است:

فیلدوب سرویس
client.Coreحساب، توکن‌ها، VPS، کلیدهای SSH، فایروال‌ها، موجودی و فاکتورها
client.Cloudابر آریانت
client.RegionalVPSVPS منطقه‌ای
client.Hostingهاستینگ
client.Baremetalسرور اختصاصی
client.SMSپیامک

پارامترهای مسیر آرگومان متد هستند، بدنه JSON درخواست body any است (struct، map یا json.RawMessage) و پارامترهای query یک struct اختیاری با نام <Group><Method>Params هستند که فیلدهایش pointer است (از arianet.String، arianet.Int و arianet.Bool استفاده کنید). هر متد یک *arianet.Response برمی‌گرداند؛ با Decode کل بدنه و با DecodeData فیلد data آن را در نوع دلخواه خود بخوانید.

resp, err := client.Cloud.CreateServer(ctx, map[string]any{
"name": "web-1",
"plan_id": 101,
"image": "ubuntu-24.04",
"datacenter": "ovh",
})

تنظیمات​

client := arianet.NewClient(token,
arianet.WithBaseURL("https://api.ariaservice.net"), // default, or $ARIANET_API_URL
arianet.WithMaxRetries(3),
arianet.WithMaxRetryWait(60*time.Second),
arianet.WithHTTPClient(&http.Client{Timeout: 30 * time.Second}),
)

WithMaxRetries تعداد تکرار (پیش‌فرض ۳) و WithMaxRetryWait بیشترین زمان انتظار پیش از هر تکرار است (پیش‌فرض ۶۰ ثانیه). اگر Retry-After بیشتر از این مقدار باشد، خطای 429 بلافاصله برمی‌گردد. برای اینکه تکرار سفارش حتی بعد از ری‌استارت برنامه هم امن باشد، کلید خودتان را با arianet.WithIdempotencyKey(key) بفرستید.

مدیریت خطا​

_, err := client.Core.CreateServer(ctx, order)
var apiErr *arianet.APIError
switch {
case arianet.HasCode(err, arianet.ErrorCodeInsufficientBalance):
// top up the wallet
case errors.As(err, &apiErr):
log.Printf("HTTP %d %s: %s", apiErr.StatusCode, apiErr.Code, apiErr.Message)
case err != nil:
log.Fatal(err) // *arianet.ConnectionError or a context error
}

APIError.Code کد پایدار خطا با حروف کوچک است و Reason در بعضی خطاها جزئیات بیشتری می‌دهد (مثلاً identity_hold). توابع کمکی IsNotFound، IsUnauthorized، IsForbidden و IsRateLimited هم در دسترس است.

ریجن و endpointهای جدید​

iran := client.RegionalVPS.WithRegion("iran-1")
resp, err := iran.ListServers(ctx)

// Any path, with the same auth, retries and errors:
resp, err = client.Do(ctx, "GET", "/cloud/v1/new-endpoint", nil, nil)