„ArchiveOverCLI” változatai közötti eltérés
(→Szalag műveletek) |
|||
10. sor: | 10. sor: | ||
* útvonal: '''/tape''' | * útvonal: '''/tape''' | ||
** ''GET'' - lekérdezhető az elérhető szalagok azonosítói | ** ''GET'' - lekérdezhető az elérhető szalagok azonosítói | ||
− | ** ''POST'' - szalag nevét lehet beállítani | + | *** paraméterek: - |
− | ** ''DELETE'' - szalag tartalmának törlése | + | *** OPCIONÁLIS paraméterek: |
+ | **** tape_id - amennyiben csak egy szalag adatai szeretnénk lekérdezni | ||
+ | *** válasz: | ||
+ | **** Egy JSON, mely tartalmazza az elérhető szalagok azonosítóit és neveit.<br /> | ||
+ | <pre> [ | ||
+ | { "id" : <szalag id>, | ||
+ | "name" : "szalag neve" | ||
+ | }, | ||
+ | ... | ||
+ | ] | ||
+ | </pre> | ||
+ | ::* példa:<br><pre> curl --header "token:<TOKEN>" -X GET 'https://api.archiver.niif.hu/tape/'</pre><br> | ||
+ | :* ''POST'' - szalag nevét lehet beállítani | ||
+ | ::* paraméterek: | ||
+ | :::* tape_id - szalag azonosítója | ||
+ | :::* name - beállítandó név | ||
+ | ::* válasz: - | ||
+ | ::* példa:<br><pre> curl --header "token:<TOKEN>" https://api.archiver.niif.hu/tape/ --data "tape_id=<ID>&name=<NAME>"</pre><br> | ||
+ | :* ''DELETE'' - szalag tartalmának törlése | ||
+ | ::* paraméterek: | ||
+ | :::* tape_id - melyik szalag tartalmát szeretnénk törölni | ||
+ | ::* válasz: - | ||
+ | ::* példa:<br><pre> curl --header "token:<TOKEN>" -X DELETE 'https://api.archiver.niif.hu/tape/?tape_id=<ID>'</pre><br> | ||
==Feladatokkal kapcsolatos műveletek== | ==Feladatokkal kapcsolatos műveletek== |
A lap 2015. május 7., 09:44-kori változata
Lehetőség van az archiválást nem csak a webes felületen keresztül használni. Erre a célra ki lett alakítva egy RESTAPI interfész, amin keresztül elérhetőek a szükséges funkciók.
Az API használatát segédletekkel megtalálhatod https://api.archiver.niif.hu/?help oldalon.
A használathoz szükséges token a webes felületen a Token fül alatt érhető el.
Tartalomjegyzék
[elrejtés]Funkcionalitások kivonatolt segédlete:
Szalag műveletek
- útvonal: /tape
- GET - lekérdezhető az elérhető szalagok azonosítói
- paraméterek: -
- OPCIONÁLIS paraméterek:
- tape_id - amennyiben csak egy szalag adatai szeretnénk lekérdezni
- válasz:
- Egy JSON, mely tartalmazza az elérhető szalagok azonosítóit és neveit.
- Egy JSON, mely tartalmazza az elérhető szalagok azonosítóit és neveit.
- GET - lekérdezhető az elérhető szalagok azonosítói
[ { "id" : <szalag id>, "name" : "szalag neve" }, ... ]
- példa:
curl --header "token:<TOKEN>" -X GET 'https://api.archiver.niif.hu/tape/'
- példa:
- POST - szalag nevét lehet beállítani
- paraméterek:
- tape_id - szalag azonosítója
- name - beállítandó név
- válasz: -
- példa:
curl --header "token:<TOKEN>" https://api.archiver.niif.hu/tape/ --data "tape_id=<ID>&name=<NAME>"
- DELETE - szalag tartalmának törlése
- paraméterek:
- tape_id - melyik szalag tartalmát szeretnénk törölni
- válasz: -
- példa:
curl --header "token:<TOKEN>" -X DELETE 'https://api.archiver.niif.hu/tape/?tape_id=<ID>'
Feladatokkal kapcsolatos műveletek
- útvonal: /archive
- POST - új archiválási feladata beküldése
- GET - lekérdezhető a beküldött feladat állapota
- útvonal: /restore
- POST - új visszaállítási feladata beküldése
- GET - lekérdezhető a beküldött feladat állapota
Fájl műveletek
- útvonal: /file
- GET - lekérdezhető a szalagon található fájlok listája