Failiem.lv API un MCP piekļuve tikai lasīšanai izstrādātājiem un programmēšanas aģentiem

Pēdējās nedēļās Failiem.lv ir paplašinājis publisko API dokumentāciju un izlaidis pirmo mitinātā Model Context Protocol (MCP) savienotāja versiju. Šie atjauninājumi atvieglo Failiem.lv mākoņkrātuves integrēšanu lietotnēs, uzņēmumu darba procesos, automatizācijas rīkos un izstrādes vidēs ar mākslīgā intelekta atbalstu.

Atjaunotajā dokumentācijā vienuviet apkopots jaunām integrācijām ieteiktais REST API V2, saderīgie V1 galapunkti, mašīnlasāma OpenAPI specifikācija un MCP lietošanas norādes. Tā paredzēta gan izstrādātājiem, gan programmatūras un programmēšanas aģentiem, kuriem nepieciešams precīzs Failiem.lv iespēju apraksts.

Kam var izmantot Failiem.lv API?

Failiem.lv REST API ļauj autorizētām lietotnēm programmatiski strādāt ar mākoņkrātuves failiem un mapēm. Atkarībā no galapunkta un konta piekļuves tiesībām integrācijas var:

• veidot mapes un augšupielādēt failus no uzņēmuma sistēmām vai automatizētiem procesiem;
• iegūt mapju satura sarakstus un failu vai mapju metadatus;
• lejupielādēt failus apstrādei, piegādei, dublēšanai vai sinhronizācijai;
• pārdēvēt, pārvietot, dzēst un atjaunot saturu;
• integrēt failu kopīgošanu, priekšskatīšanu, konvertēšanu, elektronisko parakstīšanu vai dokumentu aprites procesus;
• veidot klientu portālus, augšupielādes veidlapas, multivides apstrādes procesus, arhīvus un iekšējās integrācijas, izmantojot Failiem.lv krātuvi.

Jaunām integrācijām ieteicams izmantot API V2, ja tajā ir pieejams attiecīgais galapunkts. Dokumentētie V1 galapunkti joprojām ir pieejami saderībai un funkcijām, kurām vēl nav V2 ekvivalenta.

Dokumentācija cilvēkiem un programmatūrai

Failiem.lv API dokumentācija apkopo API aprakstus vienuviet. Izstrādātāji var izmantot OpenAPI specifikāciju ar koda ģeneratoriem, API klientiem, testēšanas rīkiem un automatizācijas platformām. Swagger UI ļauj interaktīvi iepazīt API, savukārt Markdown apraksti ir ērti lietojami gan izstrādātājiem, gan valodas modeļiem.

Šī struktūra ir īpaši noderīga integrācijas izstrādes laikā. Izstrādātājs var pārskatīt pieprasījumu parametrus un atbilžu laukus, bet programmēšanas aģents — meklēt tajos pašos avotos, pirms veido integrāciju, testus vai datu pārveidošanas kodu. Tas mazina minējumus un palīdz saglabāt ģenerētā koda atbilstību aktuālajam API aprakstam.

MCP piekļuve programmēšanas aģentiem tikai lasīšanas režīmā

Mitinātais Failiem.lv MCP galapunkts ir pieejams adresē https://api.files.fm/api/mcp. MCP nodrošina standartizētu veidu, kā saderīgi AI klienti un programmēšanas aģenti var atrast pieejamos rīkus un resursus.

Ar pašreizējo savienotāju tikai lasīšanas režīmā autentificēts aģents var:

• atrast Failiem.lv kontam pieejamos failus un mapes;
• pārlūkot mapju saturu un apskatīt metadatus;
• meklēt failu nosaukumos un pieejamajos indeksētajos metadatos;
• lasīt pieejamos failus dokumentācijā norādīto izmēra un formāta ierobežojumu ietvaros;
• meklēt Failiem.lv API dokumentācijā.

Tas palīdz, piemēram, atrast projektu specifikācijas, lasīt tehnisko dokumentāciju, sameklēt pārskatus, apkopot teksta failu saturu, salīdzināt saglabātos materiālus vai palīdzēt izstrādātājam rakstīt kodu darbam ar Failiem.lv API. Publiskās API dokumentācijas meklēšana ir pieejama arī bez piekļuves privātiem konta failiem.

Paredzēts tikai lasīšanai

Pirmā MCP versija neveic augšupielādi, pārdēvēšanu, pārvietošanu, dzēšanu, atjaunošanu, kopīgošanu vai citas failu izmaiņas. Privātajiem rīkiem nepieciešams Failiem.lv API piekļuves tokens, un rezultāti joprojām atbilst esošajām konta failu un mapju piekļuves tiesībām. Pieprasījumu biežuma un failu lasīšanas apjoma ierobežojumi palīdz padarīt automatizētu lietošanu paredzamu.

Darbības, kas maina datus, joprojām ir pieejamas REST API, kur lietotnes var nodrošināt skaidru datu pārbaudi, piekļuves tiesību kontroli, apstiprināšanu un kļūdu apstrādi. Šāds nodalījums ļauj programmēšanas aģentiem izpētīt kontekstu, bet izstrādātājiem — saglabāt kontroli pār izmaiņām.

Kā sākt

Izstrādātāji var izveidot un atsaukt API piekļuves tokenus Failiem.lv konta iestatījumos, savienot saderīgu MCP klientu ar mitināto galapunktu vai izmantot REST un OpenAPI dokumentāciju tiešas integrācijas izveidei. Reālās automatizācijās jāizmanto HTTPS, tokenus nedrīkst glabāt pirmkodā vai URL adresēs, un, kur iespējams, jāizmanto atsevišķi konti vai tokeni ar ierobežotu piekļuvi.

MCP savienotājs tikai lasīšanas režīmā ir pirmais solis plašākai aģentu izmantošanai Failiem.lv darba procesos. Turpināsim pilnveidot API, dokumentāciju un kontrolētas automatizācijas iespējas, ņemot vērā reālās integrāciju vajadzības un lietotāju atsauksmes.