Go
Instala el SDK de Go de HuntAPI y haz tu primera llamada a la API.
El SDK oficial de Go de HuntAPI, 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/huntapi/huntapi-goObtén tu clave de API
Copia tu clave de API desde el panel de HuntAPI y guárdala en la variable de entorno HUNTAPI_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/huntapi/huntapi-go"
)
func main() {
client, err := huntapi.NewClient("", nil) // reads HUNTAPI_API_KEY
if err != nil {
log.Fatal(err)
}
ctx := context.Background()
response, err := client.MediaMetadata(ctx, &huntapi.MediaMetadataParams{Query: "https://www.youtube.com/watch?v=Z5YP8kznWZs"})
if err != nil {
log.Fatal(err)
}
data, err := response.Map()
if err != nil {
log.Fatal(err)
}
fmt.Println(data)
}Trabajos asíncronos
Los endpoints de descarga son asíncronos: devuelven un job_id, y un trabajo puede durar hasta 12 horas. El SDK puede esperar a que termine.
submitted, err := client.VideoDownload(ctx, &huntapi.VideoDownloadParams{Query: "https://www.youtube.com/watch?v=Z5YP8kznWZs", VideoQuality: huntapi.String("720p")})
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, &huntapi.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.MediaMetadata(ctx, &huntapi.MediaMetadataParams{Query: "https://www.youtube.com/watch?v=Z5YP8kznWZs"})
if apiError, ok := huntapi.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 := huntapi.NewClient("", &huntapi.ClientOptions{
MaxRetries: 5, // negative disables retries
RetryDelay: 500 * time.Millisecond,
})
// or for one request
response, err := client.MediaMetadata(ctx, &huntapi.MediaMetadataParams{Query: "https://www.youtube.com/watch?v=Z5YP8kznWZs"}, huntapi.WithMaxRetries(0))Solicitudes por lotes
Ejecuta muchas llamadas a la vez, 10 por defecto. Un fallo no detiene las demás.
inputs := []string{"https://www.youtube.com/watch?v=Z5YP8kznWZs", "https://www.youtube.com/watch?v=jNQXAC9IVRw"}
results := huntapi.Batch(ctx, inputs, 5, func(ctx context.Context, value string) (*huntapi.Response, error) {
return client.MediaMetadata(ctx, &huntapi.MediaMetadataParams{Query: 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
401como una clave incorrecta. Un401tambié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
- Paquete:
huntapi-go - Código fuente: github.com/huntapi/huntapi-go
- Referencia de la API