Skip to main content
L’API HappyHorse Tasks è utilizzata per interrogare i compiti di generazione o modifica video creati dall’API HappyHorse Videos.

​
Processo di richiesta

Per utilizzare l’API HappyHorse Videos, prima vai al Pannello di controllo Ace Data Cloud per ottenere il tuo API Token, da conservare per uso futuro. Se non hai ancora effettuato il login o la registrazione, verrai automaticamente reindirizzato alla pagina di login che ti invita a registrarti e accedere; una volta completato, verrai riportato automaticamente alla pagina corrente. Un API Token è sufficiente per accedere a tutti i servizi della piattaforma, senza dover richiedere separatamente per ogni servizio. La prima richiesta ti darà un credito gratuito, per provare senza costi; quando il credito è insufficiente, puoi ricaricare il saldo generale nel pannello di controllo.
📘 Documentazione completa: HappyHorse Videos API →

​
Esempio di richiesta

L’API HappyHorse Tasks può essere utilizzata per interrogare i risultati dell’API HappyHorse Videos.

​
Impostazione dell’intestazione della richiesta e del corpo della richiesta

Request Headers include:
  • accept: specifica di ricevere la risposta in formato JSON, qui inserito come application/json.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Request Body include:
  • id: l’ID del compito da interrogare.
  • action: il modo di operare sul compito, per una singola interrogazione inserire retrieve.

​
Esempio di codice CURL

​
Esempio di risposta

Dopo una richiesta riuscita, l’API restituirà i dettagli di quel compito. Il campo request è il corpo della richiesta al momento della creazione del compito, il campo response è il corpo della risposta restituito al termine del compito, ad esempio:
La descrizione dei campi è la seguente:
  • id: l’ID del compito di generazione, utilizzato per identificare univocamente questo compito di generazione.
  • request: le informazioni della richiesta al momento della creazione del compito.
  • response: le informazioni di ritorno attuali o finali del compito.
  • created_at: data e ora di creazione del compito, timestamp Unix (secondi, float).
  • started_at: data e ora di inizio esecuzione del compito, timestamp Unix (secondi, float).
  • finished_at: data e ora di completamento del compito, timestamp Unix (secondi, float). Questo campo non viene restituito se il compito non è completato.
  • elapsed: tempo impiegato per l’esecuzione del compito, in secondi (float, con 3 cifre decimali). Questo campo non viene restituito se il compito non è completato.

​
Operazione di interrogazione in batch

Per interrogare i dettagli di più ID di compiti, impostare action su retrieve_batch e passare l’array degli ID dei compiti tramite ids:
Il risultato restituito conterrà i campi items e count, dove items è l’array dei dettagli dei compiti e count è il numero di compiti corrispondenti trovati in questa richiesta.