// sdk · Go
SDK بلغة Go لواجهة AstroWay API
وحدة Go الرسمية من AstroWay: كل endpoint في الـ API كدالة، مثل aw.Chart.Compute، مع context في كل استدعاء. إعادة المحاولة عند 408/409/429/5xx تحترم Retry-After، وطلب POST يحتفظ بمفتاح Idempotency-Key واحد، لذا الاستدعاء المُعاد لا يُحتسب مرتين. تُختبر الأخطاء باستخدام errors.Is، وتُفكّ الاستجابة إلى النوع الخاص بك. المكتبة القياسية فقط، Go 1.22+.
// 01 / install
التثبيت
go get github.com/astroway/astroway-go استيراد: astroway "github.com/astroway/astroway-go"
اعرض في السجل → github.com/astroway/astroway-go
// 02 / highlights
المميزات
- 725 دالة من مواصفات OpenAPI
- context.Context في كل استدعاء
- إعادة محاولة مع Retry-After وIdempotency-Key
- errors.Is: ErrQuotaExceeded، ErrRateLimit
- المكتبة القياسية فقط
// 03 / first request
أول طلب
package main
import (
"context"
"fmt"
"log"
"os"
astroway "github.com/astroway/astroway-go"
)
func main() {
aw := astroway.New(os.Getenv("ASTROWAY_API_KEY"))
res, err := aw.Chart.Compute(context.Background(), map[string]any{
"date": "1990-07-14", "time": "14:30:00", "timezoneOffset": 3,
"latitude": 50.4501, "longitude": 30.5234, "houseSystem": "P",
})
if err != nil {
log.Fatal(err)
}
var chart struct {
Houses struct {
Ascendant float64 `json:"ascendant"`
} `json:"houses"`
}
if err := res.Decode(&chart); err != nil {
log.Fatal(err)
}
fmt.Println(chart.Houses.Ascendant) // 212.0952574979425
} ابدأ مع Go
10,000 رصيد مجاناً شهرياً. SDK مفتوح المصدر، يتم إنشاؤه من OpenAPI 3.1، ومتزامن دائماً مع الخلفية (backend).