mirror of
https://github.com/lukaszraczylo/go-telegram.git
synced 2026-06-05 22:43:59 +00:00
lukaszraczylo
9072e9eafb
A fully-generated, strongly-typed Go client for the Telegram Bot API. * 176 methods + 301 types generated from Bot API v10.0 * 1408 auto-generated tests (8 scenarios per method) * Typed unions throughout — no 'any' in the public surface * Pluggable HTTP transport and JSON codec (default goccy/go-json) * Built-in retry middleware honouring Telegram's retry_after * Generic dispatcher with filters and conversation handlers * Self-verifying codegen pipeline (regen → audit → emit → run tests) * 14 example bots covering common patterns
28 lines
1.2 KiB
Go
28 lines
1.2 KiB
Go
package client
|
|
|
|
// Result is the universal Telegram API response envelope. Every successful
|
|
// response is shaped {"ok":true,"result":T,...}; failure responses set ok
|
|
// to false and populate ErrorCode / Description / Parameters.
|
|
//
|
|
// Result is generic over T so generated method wrappers can decode the
|
|
// strongly-typed payload directly. Users do not normally construct or
|
|
// inspect Result values; method wrappers unwrap them and return either
|
|
// the typed payload or a *APIError.
|
|
type Result[T any] struct {
|
|
OK bool `json:"ok"`
|
|
Result T `json:"result,omitempty"`
|
|
ErrorCode int `json:"error_code,omitempty"`
|
|
Description string `json:"description,omitempty"`
|
|
Parameters *ResponseParameters `json:"parameters,omitempty"`
|
|
}
|
|
|
|
// ResponseParameters is the optional metadata Telegram includes on certain
|
|
// failures. The most common is RetryAfter (seconds) on 429 responses.
|
|
//
|
|
// This type is duplicated in package api for users; keeping a copy here
|
|
// avoids an import cycle (api imports client, not vice versa).
|
|
type ResponseParameters struct {
|
|
MigrateToChatID int64 `json:"migrate_to_chat_id,omitempty"`
|
|
RetryAfter int `json:"retry_after,omitempty"`
|
|
}
|