mailinfra

package module

Go to main page

Versions in this module

v0

v0.3.0

Nov 8, 2026

Changes in this version

type BatchSendResult

+ Skip *EmailSendSkip

type Client

+ Templates *TemplatesService

type EmailDetail

+ NextAttemptAt *time.Time

+ TemplateVersionID *string

+ ThrottleDeadlineAt *time.Time

+ ThrottleReason *string

+ ThrottleStartedAt *time.Time

type EmailListItem

+ NextAttemptAt *time.Time

+ ThrottleDeadlineAt *time.Time

+ ThrottleReason *string

+ ThrottleStartedAt *time.Time

type EmailSendResponseData

+ Skip *EmailSendSkip

+ func (d EmailSendResponseData) Skipped() bool

+ type EmailSendSkip struct

+ Reason string

+ Variable string

type EmailStatus

+ const EmailStatusSkipped

type SendParams

+ ClearFromName bool

+ TemplateVersion int

+ type TemplateSnapshot map[string]any

+ func (s *TemplateSnapshot) UnmarshalJSON(data []byte) error

+ type TemplatesService struct

+ func (s *TemplatesService) Checks(ctx context.Context, slug string, draftRevision int) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Create(ctx context.Context, payload map[string]any) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Delete(ctx context.Context, slug string, draftRevision int) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Get(ctx context.Context, slug string) (*TemplateSnapshot, error)

+ func (s *TemplatesService) List(ctx context.Context, after string) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Preview(ctx context.Context, slug string, payload map[string]any) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Publish(ctx context.Context, slug string, payload map[string]any) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Restore(ctx context.Context, slug string, number int, draftRevision int) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Update(ctx context.Context, slug string, payload map[string]any) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Version(ctx context.Context, slug string, number int) (*TemplateSnapshot, error)

+ func (s *TemplatesService) Versions(ctx context.Context, slug string, before int) (*TemplateSnapshot, error)

v0.2.0

Oct 28, 2026

Changes in this version

+ const BatchIdempotencyKeyMaxLength

+ const MaxContentIDLength

+ const MaxMetadataBytes

+ const MaxMetadataKeyLength

+ const MaxMetadataKeys

+ const MaxMetadataValueLength

+ const MaxTTL

+ const MinTTL

+ var ErrEmailNotScheduled = errors.New("mailinfra: письмо уже не запланировано")

+ var ErrIPNotAllowed = errors.New(...)

+ var ErrSendAtInvalid = errors.New("mailinfra: время отправки без часового пояса")

+ var ErrSendAtTooFar = errors.New(...)

type Attachment

+ ContentID string

+ type BatchOption func(*batchOptions)

+ func WithBatchIdempotencyKey(key string) BatchOption

+ func WithoutBatchIdempotencyKey() BatchOption

+ type BatchResult struct

+ IdempotencyKey string

+ Replayed bool

+ RequestID string

type BounceCategory

+ const BounceDeliveryExpired

type EmailDetail

+ ExpiresAt *time.Time

+ Metadata map[string]string

+ ScheduledAt *time.Time

type EmailEventType

+ const EmailEventCanceled

+ const EmailEventScheduled

type EmailListItem

+ ExpiresAt *time.Time

+ Metadata map[string]string

+ ScheduledAt *time.Time

+ type EmailPage struct

+ Data []EmailListItem

+ HasMore bool

+ NextCursor string

+ type EmailPager struct

+ func (p *EmailPager) Email() EmailListItem

+ func (p *EmailPager) Err() error

+ func (p *EmailPager) Next(ctx context.Context) bool

+ type EmailScheduleData struct

+ ID string

+ ScheduledAt *time.Time

+ Status EmailStatus

type EmailStatus

+ const EmailStatusCanceled

+ const EmailStatusScheduled

type EmailsService

+ func (s *EmailsService) Cancel(ctx context.Context, emailID string) (*EmailScheduleData, error)

+ func (s *EmailsService) ListAll(params ListParams) *EmailPager

+ func (s *EmailsService) Reschedule(ctx context.Context, emailID string, sendAt time.Time) (*EmailScheduleData, error)

type ListParams

+ Cursor string

type SendParams

+ Metadata map[string]string

+ SendAt time.Time

+ TTL time.Duration

type WebhookEvent

+ func (e *WebhookEvent) EmailMetadata() map[string]string

v0.1.0

Oct 27, 2026

Changes in this version

+ const APIKeyEnvVar

+ const BaseURLEnvVar

+ const DefaultBaseURL

+ const DefaultTimeout

+ const DefaultWebhookMaxAge

+ const IdempotencyKeyMaxLength

+ const MaxAttachmentBase64Length

+ const MaxAttachments

+ const MaxBatchSize

+ const MaxContentTypeLength

+ const MaxFilenameLength

+ const MaxFromNameLength

+ const MaxRecipients

+ const MaxReplyTo

+ const MaxSubjectLength

+ const MaxTags

+ const MaxTemplateLength

+ const Version

+ const WebhookEventIDHeader

+ const WebhookReasonInvalidJSON

+ const WebhookReasonInvalidPayload

+ const WebhookReasonInvalidSecret

+ const WebhookReasonMalformedHeader

+ const WebhookReasonSignatureMismatch

+ const WebhookReasonTooOld

+ const WebhookSignatureHeader

+ var ErrAPI = errors.New("mailinfra: ошибка API")

+ var ErrAllRecipientsSuppressed = errors.New("mailinfra: все получатели в списке подавления")

+ var ErrAuthentication = errors.New("mailinfra: ошибка аутентификации")

+ var ErrBadRequest = errors.New("mailinfra: некорректный запрос")

+ var ErrConflict = errors.New("mailinfra: конфликт состояния")

+ var ErrConnection = errors.New("mailinfra: не удалось соединиться с API")

+ var ErrDomainNotAttached = errors.New("mailinfra: домен не привязан к проекту")

+ var ErrDomainNotVerified = errors.New("mailinfra: домен не подтверждён")

+ var ErrIdempotencyInFlight = errors.New(...)

+ var ErrInvalidRequest = errors.New("mailinfra: некорректные параметры запроса")

+ var ErrLegalDocumentsNotAccepted = errors.New("mailinfra: не приняты юридические документы")

+ var ErrMalformedResponse = errors.New("mailinfra: ответ API не по контракту")

+ var ErrNotFound = errors.New("mailinfra: ресурс не найден")

+ var ErrPermissionDenied = errors.New("mailinfra: недостаточно прав")

+ var ErrRateLimit = errors.New("mailinfra: превышен лимит запросов")

+ var ErrReservedEmailHeader = errors.New(...)

+ var ErrSandboxRecipientNotAllowed = errors.New(...)

+ var ErrSandboxTrialExhausted = errors.New(...)

+ var ErrServer = errors.New("mailinfra: ошибка на стороне API")

+ var ErrTemplateRender = errors.New("mailinfra: шаблон не отрендерился")

+ var ErrTemplateVariableMissing = errors.New("mailinfra: не хватает переменной шаблона")

+ var ErrTimeout = errors.New("mailinfra: истёк таймаут запроса")

+ var ErrUnprocessable = errors.New("mailinfra: запрос не прошёл валидацию")

+ var ErrWebhookSignature = errors.New("mailinfra: подпись вебхука не прошла проверку")

+ func SignWebhookPayload(body []byte, secret string, timestamp int64) string

+ func VerifyWebhookSignature(body []byte, secret, signatureHeader string, opts ...WebhookOption) bool

+ type Attachment struct

+ Content []byte

+ ContentBase64 string

+ ContentType string

+ Filename string

+ type BatchSendError struct

+ Code string

+ Details map[string]any

+ Message string

+ StatusCode int

+ type BatchSendResponseData struct

+ AcceptedCount int

+ FailedCount int

+ Results []BatchSendResult

+ type BatchSendResult struct

+ Error *BatchSendError

+ ID *string

+ Index int

+ SkippedRecipients []map[string]string

+ Status *EmailStatus

+ type BounceCategory string

+ const BounceAuthFailure

+ const BounceConnectionError

+ const BounceContentSpamBlock

+ const BounceDNSMXFailure

+ const BounceGreylisting

+ const BounceInvalidRecipient

+ const BounceMailboxFull

+ const BounceMessageTooLarge

+ const BouncePolicyRejection

+ const BounceRateLimited

+ const BounceReputationBlocklist

+ const BounceUnknown

+ type BounceType string

+ const BounceHard

+ const BounceSoft

+ type Client struct

+ Emails *EmailsService

+ func New(opts ...Option) (*Client, error)

+ func (c *Client) AutoIdempotency() bool

+ func (c *Client) BaseURL() string

+ func (c *Client) Environment() Environment

+ func (c *Client) RetryPolicy() RetryPolicy

+ type DkimSigningStatus string

+ const DkimConfirmed

+ const DkimExpected

+ const DkimFailed

+ const DkimNotSigned

+ type EmailDetail struct

+ BCCEmails []string

+ BounceCategory *BounceCategory

+ BounceType *BounceType

+ CCEmails []string

+ CreatedAt time.Time

+ DeliveredAt *time.Time

+ DkimAligned *bool

+ DkimD *string

+ DkimSelector *string

+ DkimSigningStatus *DkimSigningStatus

+ DmarcAligned *bool

+ FailedAt *time.Time

+ FinalSMTPCode *int

+ FinalSMTPEnhanced *string

+ FinalSMTPText *string

+ FromEmail string

+ FromName *string

+ HTMLBody *string

+ Headers map[string]string

+ ID string

+ MessageID *string

+ ProjectID string

+ ReplyTo []string

+ SPFAligned *bool

+ SPFAuthorizedIP *bool

+ SPFDomain *string

+ SentAt *time.Time

+ Source EmailSource

+ Status EmailStatus

+ Subject string

+ SuppressionReason *SuppressionReason

+ Tags []string

+ TextBody *string

+ ToEmails []string

+ type EmailEvent struct

+ Data map[string]any

+ ID string

+ IPAddress *string

+ Timestamp time.Time

+ Type EmailEventType

+ UserAgent *string

+ type EmailEventType string

+ const EmailEventBounced

+ const EmailEventClicked

+ const EmailEventComplained

+ const EmailEventDeferred

+ const EmailEventDelivered

+ const EmailEventFailed

+ const EmailEventOpened

+ const EmailEventQueued

+ const EmailEventSMTPConnected

+ const EmailEventSending

+ const EmailEventSent

+ const EmailEventSimulated

+ type EmailListItem struct

+ BounceCategory *BounceCategory

+ BounceType *BounceType

+ CreatedAt time.Time

+ DeliveredAt *time.Time

+ DkimAligned *bool

+ DkimD *string

+ DkimSelector *string

+ DkimSigningStatus *DkimSigningStatus

+ DmarcAligned *bool

+ FinalSMTPCode *int

+ FinalSMTPEnhanced *string

+ FinalSMTPText *string

+ FromEmail string

+ ID string

+ MessageID *string

+ ProjectID string

+ SPFAligned *bool

+ SPFAuthorizedIP *bool

+ SPFDomain *string

+ SentAt *time.Time

+ Source EmailSource

+ Status EmailStatus

+ Subject string

+ SuppressionReason *SuppressionReason

+ Tags []string

+ ToEmails []string

+ type EmailSendResponseData struct

+ ID string

+ SkippedRecipients []map[string]string

+ Status EmailStatus

+ type EmailSource string

+ const EmailSourceAPI

+ const EmailSourceCampaign

+ const EmailSourceSMTP

+ type EmailStatus string

+ const EmailStatusBounced

+ const EmailStatusComplained

+ const EmailStatusDelivered

+ const EmailStatusFailed

+ const EmailStatusQueued

+ const EmailStatusSending

+ const EmailStatusSent

+ const EmailStatusSimulated

+ type EmailsService struct

+ func (s *EmailsService) Events(ctx context.Context, emailID string) ([]EmailEvent, error)

+ func (s *EmailsService) Get(ctx context.Context, emailID string) (*EmailDetail, error)

+ func (s *EmailsService) List(ctx context.Context, params ListParams) ([]EmailListItem, error)

+ func (s *EmailsService) Send(ctx context.Context, params SendParams) (*SendResult, error)

+ func (s *EmailsService) SendBatch(ctx context.Context, emails []SendParams) (*BatchSendResponseData, error)

+ type Environment string

+ const EnvironmentLive

+ const EnvironmentTest

+ type Error struct

+ Code string

+ Details map[string]any

+ HasRetryAfter bool

+ Message string

+ RequestID string

+ RetryAfter time.Duration

+ StatusCode int

+ func (e *Error) Error() string

+ func (e *Error) Fields() []ValidationField

+ func (e *Error) Unwrap() []error

+ type ListParams struct

+ From time.Time

+ FromEmail string

+ Limit int

+ Status EmailStatus

+ Tag string

+ To time.Time

+ ToEmail string

+ type Option func(*options)

+ func WithAPIKey(apiKey string) Option

+ func WithAutoIdempotency(enabled bool) Option

+ func WithBaseURL(baseURL string) Option

+ func WithHTTPClient(httpClient *http.Client) Option

+ func WithMaxRetries(maxRetries int) Option

+ func WithRequireEnvironment(environment Environment) Option

+ func WithRetryPolicy(policy RetryPolicy) Option

+ func WithTimeout(timeout time.Duration) Option

+ func WithUserAgentSuffix(suffix string) Option

+ type RetryPolicy struct

+ BackoffFactor float64

+ InitialBackoff time.Duration

+ MaxBackoff time.Duration

+ MaxRetries int

+ MaxRetryAfter time.Duration

+ RetryableStatuses []int

+ RetryableStatusesNonIdempotent []int

+ func DefaultRetryPolicy() RetryPolicy

+ type SendParams struct

+ Attachments []Attachment

+ BCC []string

+ CC []string

+ From string

+ FromName string

+ HTML string

+ Headers map[string]string

+ IdempotencyKey string

+ ReplyTo []string

+ Subject string

+ Tags []string

+ Template string

+ Text string

+ To []string

+ Variables map[string]any

+ WithoutIdempotencyKey bool

+ type SendResult struct

+ IdempotencyKey string

+ Replayed bool

+ RequestID string

+ type SuppressionReason string

+ const SuppressionComplaint

+ const SuppressionHardBounce

+ const SuppressionManual

+ const SuppressionUnsubscribe

+ type ValidationField struct

+ Code string

+ Field string

+ Message string

+ type WebhookEvent struct

+ CreatedAt time.Time

+ Data map[string]any

+ ID string

+ Type string

+ func ConstructWebhookEvent(body []byte, secret, signatureHeader string, opts ...WebhookOption) (*WebhookEvent, error)

+ func (e *WebhookEvent) Email() map[string]any

+ func (e *WebhookEvent) EmailID() string

+ func (e *WebhookEvent) IsTest() bool

+ type WebhookOption func(*webhookOptions)

+ func WithWebhookMaxAge(maxAge time.Duration) WebhookOption

+ type WebhookSignatureError struct

+ Message string

+ Reason string

+ func (e *WebhookSignatureError) Error() string

+ func (e *WebhookSignatureError) Unwrap() error

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL