ChartQuery

Go

Instala el SDK de Go de ChartQuery y haz tu primera llamada a la API.

El SDK oficial de Go de ChartQuery, con un método tipado por endpoint y un request() genérico para lo demás.

Requisitos

  • Go 1.22+

Instalación

go get github.com/chartquery/chartquery-go

Obtén tu clave de API

Copia tu clave de API desde el panel de ChartQuery y guárdala en la variable de entorno CHARTQUERY_API_KEY, que el SDK lee por defecto. No la incluyas en el control de versiones.

Inicio rápido

package main

import (
	"context"
	"fmt"
	"log"

	"github.com/chartquery/chartquery-go"
)

func main() {
	client, err := chartquery.NewClient("", nil) // reads CHARTQUERY_API_KEY
	if err != nil {
		log.Fatal(err)
	}
	ctx := context.Background()
	response, err := client.ChartAI(ctx, &chartquery.ChartAIParams{Prompt: "Monthly revenue 2026 as a bar chart: Jan 10, Feb 14, Mar 18"})
	if err != nil {
		log.Fatal(err)
	}
	data, err := response.Map()
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(data)
}

Trabajos asíncronos

Cualquier llamada acepta is_async, útil más allá del límite de 60 segundos del servidor. La respuesta es entonces un job_id, y el SDK puede esperar a que termine el trabajo.

submitted, err := client.ChartAI(ctx, &chartquery.ChartAIParams{Prompt: "Monthly revenue 2026 as a bar chart: Jan 10, Feb 14, Mar 18", IsAsync: chartquery.Bool(true)})
if err != nil {
	log.Fatal(err)
}
var accepted struct{ JobID string `json:"job_id"` }
if err := submitted.Decode(&accepted); err != nil {
	log.Fatal(err)
}
job, err := client.WaitForJob(ctx, accepted.JobID, &chartquery.WaitForJobOptions{
	OnProgress: func(job map[string]any) { fmt.Println(job["status"], job["progress"]) },
})

Errores

Una respuesta fuera de 2xx lanza un error de API con su estado y su mensaje. Consulta los códigos de estado para ver la lista completa.

response, err := client.ChartAI(ctx, &chartquery.ChartAIParams{Prompt: "Monthly revenue 2026 as a bar chart: Jan 10, Feb 14, Mar 18"})
if apiError, ok := chartquery.IsAPIError(err); ok {
	log.Printf("HTTP %d: %s", apiError.StatusCode, apiError.Message)
}

Reintentos

Las solicitudes se reintentan hasta 3 veces tras un error de red, un 408, 500, 502, 503 o 504, o un límite de frecuencia del plan. Los errores de cuota por clave y los tiempos de espera del cliente no se reintentan. La espera empieza en 1 segundo y crece 1,5× en cada reintento, y una cabecera Retry-After tiene prioridad.

client, err := chartquery.NewClient("", &chartquery.ClientOptions{
	MaxRetries: 5,                      // negative disables retries
	RetryDelay: 500 * time.Millisecond,
})

// or for one request
response, err := client.ChartAI(ctx, &chartquery.ChartAIParams{Prompt: "Monthly revenue 2026 as a bar chart: Jan 10, Feb 14, Mar 18"}, chartquery.WithMaxRetries(0))

Solicitudes por lotes

Ejecuta muchas llamadas a la vez, 10 por defecto. Un fallo no detiene las demás.

inputs := []string{"Monthly revenue 2026 as a bar chart: Jan 10, Feb 14, Mar 18", "Market share as a pie chart: A 40, B 35, C 25"}
results := chartquery.Batch(ctx, inputs, 5, func(ctx context.Context, value string) (*chartquery.Response, error) {
	return client.ChartAI(ctx, &chartquery.ChartAIParams{Prompt: value})
})
for _, result := range results {
	if result.Err != nil {
		log.Printf("%s: %v", inputs[result.Index], result.Err)
		continue
	}
	fmt.Println(string(result.Value.Body))
}

Cualquier endpoint

request() llega a cualquier ruta, incluidos los endpoints publicados después de tu versión del SDK.

response, err := client.Request(ctx, "GET", "/v1/usage", nil)

Errores frecuentes

  • Poner la clave de API en el código front-end. Cualquiera podría leerla. Llama a la API desde tu servidor.
  • Tratar todo 401 como una clave incorrecta. Un 401 también puede ser un límite de frecuencia: lee el mensaje. El SDK reintenta por ti los límites del plan.
  • Reintentar un 402. Significa que no quedan créditos ni cuota, así que un reintento no puede funcionar. Consulta Créditos.
  • Esperar solicitudes largas. Más allá de 60 segundos, usa el modo asíncrono como se muestra arriba en lugar de aumentar el tiempo de espera. Consulta Timeout.

Enlaces

En esta página