.NET
Instale o SDK .NET da HuntAPI e faça sua primeira chamada à API.
O SDK .NET oficial da HuntAPI, com um método tipado por endpoint e um request() genérico para o resto.
Requisitos
- .NET 8+
Instalação
dotnet add package HuntApiObtenha sua chave de API
Copie sua chave de API no painel da HuntAPI e coloque-a na variável de ambiente HUNTAPI_API_KEY, que o SDK lê por padrão. Não a inclua no controle de versão.
Início rápido
using HuntApi;
using var client = new HuntApiClient();
var response = await client.MediaMetadataAsync(new MediaMetadataParams { Query = "https://www.youtube.com/watch?v=Z5YP8kznWZs" });
Console.WriteLine(response.Json);Jobs assíncronos
Os endpoints de download são assíncronos: retornam um job_id, e um job pode durar até 12 horas. O SDK pode aguardar o fim.
var submitted = await client.VideoDownloadAsync(new VideoDownloadParams { Query = "https://www.youtube.com/watch?v=Z5YP8kznWZs", VideoQuality = "720p" });
var job = await client.WaitForJobAsync(
submitted.Json.GetProperty("job_id").GetString()!,
onProgress: j => Console.WriteLine($"{j.GetProperty("status")} {j.GetProperty("progress")}%"));Erros
Uma resposta fora de 2xx gera um erro de API com status e mensagem. Veja os códigos de status para a lista completa.
try
{
await client.MediaMetadataAsync(new MediaMetadataParams { Query = "https://www.youtube.com/watch?v=Z5YP8kznWZs" });
}
catch (HuntApiApiException exception)
{
Console.Error.WriteLine($"{exception.StatusCode}: {exception.Message}");
}Novas tentativas
As requisições são repetidas até 3 vezes após um erro de rede, um 408, 500, 502, 503 ou 504, ou um limite de taxa do plano. Erros de cota por chave e timeouts do cliente não são repetidos. A espera começa em 1 segundo e cresce 1,5× a cada tentativa, e um cabeçalho Retry-After tem prioridade.
using var client = new HuntApiClient(new HuntApiClientOptions { MaxRetries = 5, RetryDelay = TimeSpan.FromMilliseconds(500) });
await client.MediaMetadataAsync(new MediaMetadataParams { Query = "https://www.youtube.com/watch?v=Z5YP8kznWZs" }, new RequestOptions { MaxRetries = 0 }); // one request without retriesRequisições em lote
Execute muitas chamadas de uma vez, 10 por padrão. Uma falha não interrompe as outras.
string[] inputs = { "https://www.youtube.com/watch?v=Z5YP8kznWZs", "https://www.youtube.com/watch?v=jNQXAC9IVRw" };
var results = await client.BatchAsync(inputs, (value, ct) =>
client.MediaMetadataAsync(new MediaMetadataParams { Query = value }, cancellationToken: ct), concurrency: 5);
foreach (var result in results)
{
if (result.Ok)
{
Console.WriteLine(result.Value!.Json);
}
else
{
Console.Error.WriteLine($"{inputs[result.Index]}: {result.Error!.Message}");
}
}Qualquer endpoint
request() alcança qualquer caminho, inclusive endpoints lançados depois da sua versão do SDK.
var response = await client.RequestAsync("GET", "/v1/usage");Erros comuns
- Colocar a chave de API no código front-end. Qualquer pessoa poderia lê-la. Chame a API a partir do seu servidor.
- Tratar todo
401como chave incorreta. Um401também pode ser um limite de taxa: leia a mensagem. O SDK repete automaticamente os limites do plano. - Repetir um
402. Não há mais créditos nem cota, então uma nova tentativa não pode funcionar. Veja Créditos. - Esperar requisições longas. Acima de 60 segundos, use o modo assíncrono como mostrado acima em vez de aumentar o timeout. Veja Timeout.
Links
- Pacote:
HuntApi - Código-fonte: github.com/huntapi/huntapi-dotnet
- Referência da API