client

type APIError struct {
	Code    int
	Msg     string
	TraceID string
}

type Client struct {
	BaseURL    string
	AccessKey  string
	SecretKey  string
	HTTP       *http.Client
	UserAgent  string
	MaxRetries int
	// RetryNonIdempotent also retries POSTs on 5xx/network errors. Off by
	// default because create/delete must not be duplicated.
	RetryNonIdempotent bool
}

type Envelope struct {
	TraceID string          `json:"traceId"`
	Code    int             `json:"code"`
	Msg     string          `json:"msg"`
	Data    json.RawMessage `json:"data"`
	Status  string          `json:"status"`

	// Paginated endpoints (phone/list, app/list, network/list, ...) put the
	// page at the top level as {total, rows} instead of inside data. Keep both
	// so the output layer can normalize them without losing the list.
	Total json.RawMessage `json:"total,omitempty"`
	Rows  json.RawMessage `json:"rows,omitempty"`
}

type HTTPError struct {
	StatusCode int
	Body       string
}

type Request struct {
	Method string
	Path   string // spec path, starting with /open/api/
	Query  url.Values
	Body   any
}