Something went wrong. Try again.
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172package cli
import ( "bytes" "encoding/json" "errors" "fmt" "io" "net/url" "os" "strconv" "strings" "time"
"github.com/spf13/cobra")
func newAPICmd(app *App) *cobra.Command { var ( method, host, aud, input string rawFields, typedFields []string ) cmd := &cobra.Command{ Use: "api <method>", Short: "Make an authenticated XRPC request", Long: `Call an XRPC method and print the JSON response.
By default the request goes to the Tangled API (bobbin). Use --host to call aknot or another service, or --host pds to call your own PDS with your session.
Fields are sent as query parameters for GET requests and as a JSON object forPOST requests. -f sends a string; -F turns true, false, null, and numbers intoJSON values. --input sends a file (or "-" for standard input) as the body.
With --aud, the request carries a service-auth token for that audience, mintedby your PDS and bound to the method. Knots expect the repository DID as theaudience for repository writes, and their own did:web otherwise.`, Example: ` knit api org.tangled.repo.listRepos -f subject=did:plc:abc123 knit api org.tangled.repo.getRepoByName -f owner=did:plc:abc123 -f name=core knit api --host pds com.atproto.server.getSession knit api --host knot1.tangled.sh --aud did:plc:repo -X POST com.atproto.repo.createRecord --input record.json`, Args: cobra.ExactArgs(1), RunE: func(cmd *cobra.Command, args []string) error { ctx := cmd.Context() nsid := args[0] method = strings.ToUpper(method) fields := map[string]any{} for _, f := range rawFields { k, v, ok := strings.Cut(f, "=") if !ok { return fmt.Errorf("field %q must be key=value", f) } addField(fields, k, v) } for _, f := range typedFields { k, v, ok := strings.Cut(f, "=") if !ok { return fmt.Errorf("field %q must be key=value", f) } addField(fields, k, typedValue(v)) } var body any = fields if input != "" { var data []byte var err error if input == "-" { data, err = io.ReadAll(app.In) } else { data, err = os.ReadFile(input) } if err != nil { return err } body = json.RawMessage(data) if method == "GET" { method = "POST" } }
c := app.Client() var out json.RawMessage var err error switch { case host == "pds" && method == "GET": err = c.PDSGet(ctx, nsid, fields, &out) case host == "pds": err = c.PDSPost(ctx, nsid, body, &out) default: if host == "" { host = c.API } token := "" if aud != "" { if token, err = c.ServiceAuth(ctx, aud, nsid, time.Minute); err != nil { return err } } if method == "GET" { params := url.Values{} for k, v := range fields { if list, ok := v.([]any); ok { for _, item := range list { params.Add(k, fmt.Sprint(item)) } } else { params.Set(k, fmt.Sprint(v)) } } if token != "" { err = errors.New("--aud is only supported for POST requests") } else { err = c.Query(ctx, host, nsid, params, &out) } } else { err = c.Procedure(ctx, host, nsid, token, body, &out) } } if err != nil { return err } if len(out) == 0 { return nil } var pretty bytes.Buffer if json.Indent(&pretty, out, "", " ") != nil { _, err = app.Out.Write(out) return err } app.Printf("%s\n", pretty.String()) return nil }, } cmd.Flags().StringVarP(&method, "method", "X", "GET", "HTTP method: GET for queries, POST for procedures") cmd.Flags().StringVar(&host, "host", "", `Service host, or "pds" for your PDS (default: the Tangled API)`) cmd.Flags().StringVar(&aud, "aud", "", "Send a service-auth token for this audience DID") cmd.Flags().StringArrayVarP(&rawFields, "raw-field", "f", nil, "Add a string field in `key=value` format") cmd.Flags().StringArrayVarP(&typedFields, "field", "F", nil, "Add a typed field in `key=value` format") cmd.Flags().StringVar(&input, "input", "", "Send the contents of `file` as the request body") return cmd}
// addField sets k, collecting repeated keys into a list for array params.func addField(fields map[string]any, k string, v any) { if prev, ok := fields[k]; ok { if list, ok := prev.([]any); ok { fields[k] = append(list, v) } else { fields[k] = []any{prev, v} } return } fields[k] = v}
func typedValue(v string) any { switch v { case "true": return true case "false": return false case "null": return nil } if n, err := strconv.ParseInt(v, 10, 64); err == nil { return n } if f, err := strconv.ParseFloat(v, 64); err == nil { return f } return v}