Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Immaniġġja l-fajls tiegħek: elenka, irkupra, ħassar

Lezzjoni 3 / 16 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. X’jiġri wara l-mitt upload
  2. Agħmel l-inventarju
  3. Ivverifika fajl speċifiku
  4. Ħassar, u x’għandek tiċċekkja qabel
  5. Żomm il-ħażna tiegħek nadifa
  6. Punti Ewlenin

X’jiġri wara l-mitt upload

It-tlugħ ta’ fajl jieħu tliet sekondi; issib dak li bgħatt sitt ġimgħat ilu jieħu ħafna iktar jekk ma ppjanajtx minn qabel. Wara t-testijiet inizjali, kont jakkumula għexieren u mbagħad mijiet ta’ dokumenti. Uħud huma antikwati, oħrajn idduplikati, u oħrajn qed jiġu referenzjati minn applikazzjonijiet li għadhom jaħdmu. Il-Files API tesponi tliet operazzjonijiet biex timmaniġġja dan l-inventarju: elenka, irkupra, u ħassar. Jidhru sekondarji meta l-volum huwa baxx, iżda jsiru indispensabbli iktar ‘il quddiem.

Agħmel l-inventarju

GET /v1/files jirritorna l-fajls kollha mtellgħa fil-kont tiegħek:

curl https://api.x.ai/v1/files \
  -H "Authorization: Bearer $XAI_API_KEY"

Ir-risposta hija lista paġinata, fejn kull entrata tirrepeti l-metadejta li rajt waqt it-tlugħ:

{
  "object": "list",
  "data": [
    {
      "id": "file_abc123",
      "object": "file",
      "bytes": 2458901,
      "created_at": 1710000000,
      "filename": "rapport-annuel.pdf",
      "purpose": "assistants"
    },
    {
      "id": "file_def456",
      "object": "file",
      "bytes": 15230,
      "created_at": 1710100000,
      "filename": "données-clients.csv",
      "purpose": "assistants"
    }
  ]
}

Din il-viżwa ssolvi tliet sitwazzjonijiet konkreti ħafna: l-irkupru ta’ file_id li ma ssalvajtx waqt it-tlugħ, iċ-ċekkjar tad-daqs attwali ta’ dokument li jidher abnormalment tqil, u l-identifikazzjoni ta’ kandidati għat-tħassir billi tissortja fuq created_at. Hija wkoll l-uniku post fejn tara f’daqqa waħda li l-istess rapport intbagħat tliet darbiet taħt tliet ismijiet differenti.

Ivverifika fajl speċifiku

Meta diġà tkun taf l-identifikatur, GET /v1/files/{file_id} jistaqsi għal dokument wieħed:

curl https://api.x.ai/v1/files/file_abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"

Tirkupra l-istess informazzjoni bħal waqt it-tlugħ: identifikatur, isem, daqs, data tal-ħolqien, u skop. L-aktar użu utli ta’ din is-sejħa huwa difensiv. Qabel tniedi proċess li jirreferenzja file_id maħżun għal żmien twil fil-bażi tad-data tiegħek, verifika li ddum ftit millisekondi tiffrankalek żball f’nofs katina ta’ talbiet bi ħlas.

Ħassar, u x’għandek tiċċekkja qabel

It-tħassir isir b’DELETE /v1/files/{file_id} u r-risposta tikkonferma l-operazzjoni:

curl -X DELETE https://api.x.ai/v1/files/file_abc123 \
  -H "Authorization: Bearer $XAI_API_KEY"
{
  "id": "file_abc123",
  "object": "file",
  "deleted": true
}

Huma meħtieġa żewġ verifiki qabel ma tiġbed il-grillu. L-ewwel, il-fajl jista’ jkun referenzjat f’kollezzjoni—kunċett li se niddettaljaw f’lezzjonijiet li ġejjin. It-tħassir tiegħu permezz tal-Files API ma jneħħihx awtomatikament mill-kollezzjoni, u jħallik b’referenza mejta fl-indiċi tiegħek: neħħih mill-kollezzjoni l-ewwel, imbagħad mill-ħażna. It-tieni, il-fajl jista’ jintuża minn flussi ta’ xogħol attivi; kwalunkwe applikazzjoni li żżomm dan il-file_id fil-bażi tad-data tagħha se tirċievi żbalji hekk kif isir it-tħassir, spiss fil-produzzjoni u rari waqt li tkun qed timmonitorja l-logs.

Żomm il-ħażna tiegħek nadifa

L-ismijiet huma l-ewwel għodda ta’ ġestjoni tiegħek, għax l-isem oriġinali jinżamm fil-metadejta u jikkostitwixxi l-uniku markatur li jista’ jinqara f’lista ta’ mitt entrata. rapport-q1-2026.pdf ifisser xi ħaġa għalik fi tmien xhur; document.pdf qatt mhux se jfisser. L-istess raġunament japplika għal api-specs-v2.json meta mqabbel ma’ data.json. Agħmel dan drawwa meta tħejji l-fajl fuq id-disk tiegħek, mhux waqt it-tlugħ: huwa l-isem lokali li jiġi trażmess.

Il-fajls imtellgħa jibqgħu maħżuna għal żmien indefinit, mingħajr skadenza awtomatika. rutina ta’ tindifa kwartali hija biżżejjed biex tevita d-devjazzjoni, fi tliet passi:

  1. Elenka l-fajls tiegħek b’GET /v1/files
  2. Identifika dawk li m’għadhomx qed jintużaw, skont id-data tal-ħolqien jew l-isem
  3. Ħassarhom b’DELETE /v1/files/{file_id}

Tliet kodiċijiet ta’ żball joħorġu f’dawn l-operazzjonijiet u jiġu djanjostikati immedjatament. 404 jindika fajl li ma jeżistix jew diġà mħassar, każ tipiku ta’ skript ta’ tindifa mħaddem darbtejn. 401 ġej minn ċavetta API nieqsa jew invalida, spiss varjabbli tal-ambjent mhux imħaddma fil-qoxra attwali. 413 jindika li l-fajl jaqbeż il-48 MB permessi u jseħħ waqt it-tlugħ, mhux waqt il-ġestjoni.

Punti Ewlenin

  • GET /v1/files jelenka l-fajls kollha tiegħek bil-metadejta tagħhom
  • GET /v1/files/{id} jirkupra fajl speċifiku
  • DELETE /v1/files/{id} iħassar fajl b’mod permanenti
  • Semmi l-fajls tiegħek b’mod espliċitu biex tiffaċilita l-ġestjoni
  • Iċċekkja d-dipendenzi (kollezzjonijiet, flussi ta’ xogħol) qabel ma tħassar