ارسال پیامک با Go

کتابخانه رسمی Go همه اندپوینت‌های پیامک و پیام‌رسان ادسفید را با مدل‌های درخواست و پاسخ نوع‌دار پوشش می‌دهد. نشانی پیش‌فرض آن https://api.adsefid.com است و کلید API را در هدر X-API-KEY می‌فرستد.

adsefid/sdk-go pkg.go.dev مستندات کامل API

نصب

پیش‌نیاز:: Go 1.22+

$go get github.com/adsefid/sdk-go

ارسال اولین پیامک

کلید API را از متغیر محیطی ADSEFID_API_KEY بخوانید و به کلاینت بدهید. SDK هیچ متغیر محیطی را خودکار نمی‌خواند.

package main

import (
	"context"
	"fmt"
	"log"
	"os"

	adsefid "github.com/adsefid/sdk-go"
)

func main() {
	client, err := adsefid.NewClient(os.Getenv("ADSEFID_API_KEY"))
	if err != nil {
		log.Fatal(err)
	}

	resp, err := client.SMS.SendSingle(context.Background(), &adsefid.SendSingleSmsRequest{
		Receptor:   "98912xxxxxxx",
		LineNumber: "983000XXX",
		Message:    "Hello from adsefid",
	})
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("message_id=%s status=%s\n", resp.MessageID, resp.Status)
}

بررسی امضای وب‌هوک

این تابع هدر X-Atlas-Webhook-Signature و زمان درخواست را بررسی می‌کند و بدنه را به یک رویداد نوع‌دار تبدیل می‌کند. همیشه بدنه خام درخواست را، پیش از هر JSON parse، به آن بدهید.

webhooks.Verify(rawBody, signature, timestamp, secret)

نمونه‌های کامل و قابل اجرا، از جمله گیرنده وب‌هوک، در پوشه examples مخزن قرار دارند.