Skip to main content
A API HappyHorse Tasks é utilizada para consultar as tarefas de geração ou edição de vídeos criadas pela API HappyHorse Videos.

​
Processo de Solicitação

Para usar a API HappyHorse Videos, primeiro acesse o Painel de Controle Ace Data Cloud para obter seu Token de API, que deve ser guardado para referência futura. Se você ainda não estiver logado ou registrado, será redirecionado automaticamente para a página de login, onde será convidado a se registrar e logar. Após a conclusão, você será redirecionado de volta para a página atual. Um Token de API é suficiente para acessar todos os serviços da plataforma, não sendo necessário solicitar um para cada serviço. A primeira solicitação vem com um crédito gratuito, permitindo uma experiência sem custo; quando o crédito estiver baixo, você pode recarregar o saldo geral no painel de controle.
📘 Documentação Completa: HappyHorse Videos API →

​
Exemplo de Solicitação

A API HappyHorse Tasks pode ser utilizada para consultar os resultados da API HappyHorse Videos.

​
Configurando Cabeçalhos e Corpo da Solicitação

Cabeçalhos da Solicitação incluem:
  • accept: especifica que a resposta deve ser no formato JSON, preenchido como application/json.
  • authorization: chave para chamar a API, que pode ser selecionada diretamente após a solicitação.
Corpo da Solicitação inclui:
  • id: ID da tarefa a ser consultada.
  • action: forma de operação na tarefa, para consulta única, preencha como retrieve.

​
Exemplo de Código CURL

​
Exemplo de Resposta

Após uma solicitação bem-sucedida, a API retornará os detalhes da tarefa. O campo request é o corpo da solicitação ao criar a tarefa, e o campo response é o corpo da resposta retornada após a conclusão da tarefa, por exemplo:
A descrição dos campos é a seguinte:
  • id: ID da tarefa gerada, usado para identificar exclusivamente esta tarefa de geração.
  • request: informações da solicitação ao criar a tarefa.
  • response: informações de retorno atuais ou finais da tarefa.
  • created_at: horário de criação da tarefa, timestamp Unix (segundos, ponto flutuante).
  • started_at: horário de início da execução da tarefa, timestamp Unix (segundos, ponto flutuante).
  • finished_at: horário de conclusão da tarefa, timestamp Unix (segundos, ponto flutuante). Este campo não é retornado se a tarefa não estiver concluída.
  • elapsed: tempo gasto na execução da tarefa, em segundos (ponto flutuante, com 3 casas decimais). Este campo não é retornado se a tarefa não estiver concluída.

​
Operação de Consulta em Lote

Para consultar detalhes de várias tarefas ID, defina action como retrieve_batch e passe um array de IDs de tarefas através de ids:
O resultado retornado incluirá os campos items e count, onde items é um array de detalhes da tarefa e count é o número de tarefas correspondentes encontradas.