mirror of
https://github.com/hanzo-go/sdk.git
synced 2026-11-20 20:13:42 +00:00
Modules declare go 1.27.1 and the build images follow. go fix applied the modernizers, and the left and when test helpers went once new(expr) could say them; omitzero is not applied, since it changes what the JSON says. Co-authored-by: Hanzo Dev <[email protected]>
55 lines
1.9 KiB
Go
55 lines
1.9 KiB
Go
// errors — read a refusal.
|
|
//
|
|
// Not one of the six cross-SDK flows. This is Go's own contract, and it is the
|
|
// part of a generated client a caller learns once: every Execute returns
|
|
// (value, *http.Response, error), and on a refusal all three carry something.
|
|
//
|
|
// - The status code is on the RESPONSE, which comes back ALONGSIDE the error
|
|
// rather than instead of it. The error's own Error() is the status line as
|
|
// text, so there is no code to parse back out of it.
|
|
// - The error is a *hanzoai.GenericOpenAPIError, and Body() is what the API
|
|
// actually said. The client re-wraps the response body before returning, so
|
|
// reading one does not consume the other.
|
|
// - The response is nil when the request never went out — a bad base URL, a
|
|
// transport failure, a cancelled context — and that is the case worth
|
|
// separating, because retrying it means something different.
|
|
//
|
|
// This calls GET /v1/keys. Run it with no credentials in the environment and
|
|
// it walks the failure path: a client with nothing to present sends nothing,
|
|
// and the route refuses, which is the truth about a caller that cannot say
|
|
// who it is. Run it with credentials and it prints the count instead.
|
|
//
|
|
// go run ./examples/errors
|
|
package main
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
"log"
|
|
|
|
hanzoai "github.com/hanzoai/go-sdk/v8"
|
|
)
|
|
|
|
func main() {
|
|
client := hanzoai.New(hanzoai.Options{})
|
|
|
|
listing, resp, err := client.AccountAPI.GetAccountKeys(context.Background()).Execute()
|
|
if err == nil {
|
|
fmt.Printf("accepted %d key(s)\n", len(listing.Keys))
|
|
return
|
|
}
|
|
if resp == nil {
|
|
// The API never answered, so there is no status and no body to read.
|
|
log.Fatalf("unsent: %v", err)
|
|
}
|
|
|
|
fmt.Printf("status %s\n", resp.Status)
|
|
|
|
if apiErr, ok := errors.AsType[*hanzoai.GenericOpenAPIError](err); ok {
|
|
fmt.Printf("refused %s\n", apiErr.Body())
|
|
return
|
|
}
|
|
fmt.Printf("failed %v\n", err)
|
|
}
|