Java
Instale o SDK Java da HuntAPI e faça sua primeira chamada à API.
O SDK Java oficial da HuntAPI, com um método tipado por endpoint e um request() genérico para o resto.
Requisitos
- Java 17+
Instalação
O SDK Java não está no Maven Central. Compile-o a partir do código-fonte para instalá-lo no seu repositório Maven local e depois adicione-o ao seu projeto.
git clone https://github.com/huntapi/huntapi-java.git
cd huntapi-java
mvn -q install -DskipTests<dependency>
<groupId>com.huntapi</groupId>
<artifactId>huntapi</artifactId>
<version>0.1.0</version>
</dependency>implementation("com.huntapi:huntapi:0.1.0")Obtenha 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
import com.huntapi.ApiResponse;
import com.huntapi.HuntApiClient;
import com.huntapi.params.MediaMetadataParams;
HuntApiClient client = HuntApiClient.fromEnv();
ApiResponse response = client.mediaMetadata(MediaMetadataParams.builder().query("https://www.youtube.com/watch?v=Z5YP8kznWZs").build());
System.out.println(response.json().toPrettyString());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.
ApiResponse submitted = client.videoDownload(VideoDownloadParams.builder().query("https://www.youtube.com/watch?v=Z5YP8kznWZs").videoQuality("720p").build());
ApiResponse job = client.waitForJob(
submitted.json().get("job_id").asText(),
Duration.ofSeconds(3),
Duration.ofHours(12),
progress -> System.out.println(progress.path("status").asText() + " " + progress.path("progress").asInt()));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 {
client.mediaMetadata(MediaMetadataParams.builder().query("https://www.youtube.com/watch?v=Z5YP8kznWZs").build());
} catch (HuntApiApiException e) {
System.err.println(e.status() + ": " + e.getMessage());
}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.
HuntApiClient client = HuntApiClient.builder().maxRetries(5).retryDelay(Duration.ofMillis(500)).build();
client.mediaMetadata(MediaMetadataParams.builder().query("https://www.youtube.com/watch?v=Z5YP8kznWZs").build(), RequestOptions.builder().maxRetries(0).build()); // one request without retriesRequisições em lote
Execute muitas chamadas de uma vez, 10 por padrão. Uma falha não interrompe as outras.
List<String> inputs = List.of("https://www.youtube.com/watch?v=Z5YP8kznWZs", "https://www.youtube.com/watch?v=jNQXAC9IVRw");
List<BatchResult<ApiResponse>> results = client.batch(inputs, 5, value ->
client.mediaMetadata(MediaMetadataParams.builder().query(value).build()));
for (BatchResult<ApiResponse> result : results) {
if (result.ok()) {
System.out.println(result.value().json());
} else {
System.err.println(inputs.get(result.index()) + ": " + result.error().getMessage());
}
}Qualquer endpoint
request() alcança qualquer caminho, inclusive endpoints lançados depois da sua versão do SDK.
ApiResponse response = client.request("GET", "/v1/usage", Map.of());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-java - Código-fonte: github.com/huntapi/huntapi-java
- Referência da API