SDK زبان Go
ماژول github.com/ariaservice/arianet-go کلاینت رسمی Go برای وب سرویسهای آریانت است. فقط از کتابخانه استاندارد Go استفاده میکند و به Go نسخه ۱.۲۲ یا بالاتر نیاز دارد.
- سورس: github.com/ariaservice/arianet-go (نسخه فعلی 0.1.0)
- مستندات کد: pkg.go.dev/github.com/ariaservice/arianet-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.RegionalVPS | VPS منطقهای |
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)