Passa al contenuto principale

Carica un file

  • Recupera l'URL di caricamento.
  • Carica il file utilizzando l'URL tramite il metodo PUT.
  • Contrassegna il caricamento del file come completato.

Per recuperare un URL di caricamento​

Questa API genera un URL prefirmato per i caricamenti di file, consentendo il caricamento diretto dei file nella posizione specificata. Si prega di notare che l'URL è sensibile al tempo e scadrà dopo 5 minuti.

Endpoint​

POST https://usapi.hottask.com/chat/User/GetPreUploadUrl

Intestazioni della richiesta​

La richiesta API deve includere le seguenti intestazioni:

Authorization: <Your-Secret-Key> - La chiave segreta per autenticare la richiesta API. Content-Type: application/json - Il tipo di contenuto del payload della richiesta.

Corpo della richiesta​

Il corpo della richiesta deve contenere i seguenti parametri:

{
// fileName(string, required): Il nome del file. ES: companyinfo.txt
"fileName":"companyinfo.txt"
}

Richieste di esempio​

JavaScript (API Fetch)​

const res = await fetch('https://usapi.hottask.com/chat/User/GetPreUploadUrl', {
method: 'POST',
headers: {
'Authorization': `<Your-Secret-Key>`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
fileName: '<Your filename>',
}),
});

const data = await res.json();
console.log(data);

Python (Libreria Richieste)​

import request
import JSON

url = 'https://usapi.hottask.com/chat/User/GetPreUploadUrl'
headers = {
'Authorization': '<Your-Secret-Key>',
'Content-Type': 'application/json'
}
data = {
'fileName': '<Your filename>'
}

response = requests.post(url, headers=headers, data=json.dumps(data))
data = response.json()

print(data)

cURL​

curl https://usapi.hottask.com/chat/User/GetPreUploadUrl \
-H 'Content-Type: application/json' \
-H 'Authorization: <Your-Secret-Key>' \
-d '{"fileName": "your nomefile"}'

Richiesta HTTP​

POST /chat/User/GetPreUploadUrl HTTP/1.1
Host: usapi.hottask.com
Authorization: <Your-Secret-Key>
Content-Type: application/json

{
"fileName": "<Your filename>"
}

Risposta​

La risposta API sarà un oggetto JSON con la seguente struttura:

{
"Data": {
"FileStoreId":"34317",
"PreUploadUrl":"https://xxx.s3.us-west-1.amazonaws.com/xxx/3706/627855d5-ba01-4732-9dfd-b08a72744c77.txt?X-Amz-Expires=600\u0026X-Amz-Algorithm=AWS4-HMAC-SHA256\u0026X-Amz-Credential=AKIA5TS7CBKE4ZSW BI46%2F20250121%2Fus-west-1%2Fs3%2Faws4_request\u0026X-Amz-Date=20250121T030214Z\u0026X-Amz-SignedHeaders=host\u0026X-Amz-Signature=a237335d9b2e6fad1c648f753d393906647db5528eaaecf5e55dd114a22653db",
},
"Versione": "1.0.0",
"Riuscito": true,
"Codice": 200,
"Messaggio":""
}

Gestione degli errori​

Se si tratta di un errore di rete HTTP, è necessario controllare il codice di stato HTTP. Se si tratta di un'eccezione aziendale, è necessario esaminare i campi Codice e Messaggio, che forniranno i dettagli dell'errore.

Ecco fatto! Ora dovresti essere in grado di creare un chatbot utilizzando l'API di creazione.

Contrassegna il caricamento come riuscito​

Questa API consente all'utente di contrassegnare il file come caricato correttamente.

Endpoint​

POST https://usapi.hottask.com/chat/User/ReportUploadSuccess

Intestazioni della richiesta​

La richiesta API deve includere le seguenti intestazioni:

Authorization: <Your-Secret-Key> - La chiave segreta per autenticare la richiesta API. Content-Type: application/json - Il tipo di contenuto del payload della richiesta.

Corpo della richiesta​

Il corpo della richiesta deve contenere i seguenti parametri:

{
// fileStoreID(string, required): L'ID del file.
"fileStoreID":"123"
}

Richiesta di esempio​

JavaScript (API Fetch)​

const res = await fetch('https://usapi.hottask.com/chat/User/ReportUploadSuccess', {
method: 'POST',
headers: {
'Authorization': `<Your-Secret-Key>`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
fileStoreID: '123'
}),
});

const data = await res.json();
console.log(data);

Python (Libreria Richieste)​

import request
import JSON

url = 'https://usapi.hottask.com/chat/User/ReportUploadSuccess'
headers = {
'Authorization': '<Your-Secret-Key>',
'Content-Type': 'application/json'
}
data = {
'fileStoreID': '123'
}

response = requests.post(url, headers=headers, data=json.dumps(data))
data = response.json()

print(data)

cURL​

curl https://usapi.hottask.com/chat/User/ReportUploadSuccess \
-H 'Content-Type: application/json' \
-H 'Authorization: <Your-Secret-Key>' \
-d '{"fileStoreID": "123"}'

Richiesta HTTP​

POST /chat/User/ReportUploadSuccess HTTP/1.1
Host: usapi.hottask.com
Authorization: <Your-Secret-Key>
Content-Type: application/json

{
"fileStoreID": "123"
}

Risposta​

La risposta API sarà un oggetto JSON con la seguente struttura:

{
"Data": true,
"Version": "1.0.0",
"Success": true,
"Code": 200,
"Message":""
}

Se si tratta di un errore di rete HTTP, è necessario controllare il codice di stato HTTP. Se si tratta di un'eccezione aziendale, è necessario esaminare i campi Code e Message, che forniranno i dettagli dell'errore.

Ecco fatto! Ora dovresti essere in grado di caricare un file utilizzando queste due API.