Go
Installieren Sie das Go-SDK von HuntAPI und starten Sie Ihren ersten API-Aufruf.
Das offizielle Go-SDK von HuntAPI mit einer typisierten Methode pro Endpunkt und einem generischen request() für alles andere.
Voraussetzungen
- Go 1.22+
Installation
go get github.com/huntapi/huntapi-goAPI-Schlüssel erhalten
Kopieren Sie Ihren API-Schlüssel aus dem HuntAPI-Dashboard und legen Sie ihn in der Umgebungsvariable HUNTAPI_API_KEY ab, die das SDK standardmäßig liest. Checken Sie ihn nicht in die Versionsverwaltung ein.
Schnellstart
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)
}Asynchrone Jobs
Download-Endpunkte sind asynchron: Sie geben eine job_id zurück, und Jobs können bis zu 12 Stunden laufen. Das SDK kann auf ihr Ende warten.
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"]) },
})Fehler
Eine Antwort außerhalb von 2xx löst einen API-Fehler mit Status und Meldung aus. Die vollständige Liste finden Sie unter Statuscodes.
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)
}Wiederholungen
Anfragen werden bis zu 3-mal wiederholt nach einem Netzwerkfehler, einem 408, 500, 502, 503 oder 504 oder einem Ratenlimit des Tarifs. Kontingentfehler pro Schlüssel und clientseitige Timeouts werden nicht wiederholt. Die Wartezeit beginnt bei 1 Sekunde und wächst pro Wiederholung um das 1,5-Fache; ein Retry-After-Header hat Vorrang.
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))Batch-Anfragen
Führen Sie viele Aufrufe gleichzeitig aus, standardmäßig 10. Ein Fehler stoppt die anderen nicht.
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))
}Beliebiger Endpunkt
request() erreicht jeden Pfad, auch Endpunkte, die nach Ihrer SDK-Version erschienen sind.
response, err := client.Request(ctx, "GET", "/v1/usage", nil)Häufige Fehler
- Den API-Schlüssel in Frontend-Code einbauen. Jeder könnte ihn lesen. Rufen Sie die API von Ihrem Server auf.
- Jeden
401als falschen Schlüssel behandeln. Ein401kann auch ein Ratenlimit sein: Lesen Sie die Meldung. Das SDK wiederholt Tarif-Ratenlimits automatisch. - Einen
402wiederholen. Es sind keine Credits oder Kontingente mehr übrig, eine Wiederholung kann also nicht gelingen. Siehe Credits. - Auf lange Anfragen warten. Nutzen Sie ab 60 Sekunden den asynchronen Modus wie oben gezeigt, statt das Timeout zu erhöhen. Siehe Timeout.
Links
- Paket:
huntapi-go - Quellcode: github.com/huntapi/huntapi-go
- API-Referenz