Dokumentacja API
Niniejsza dokumentacja opisuje dostępne funkcje API dla Chmurz.sewada.com, które mogą zostać użyte do tworzenia zewnetrznych aplikacji.
Informacje
Każde zapytanie do API odpowiada w formacie "application/json" i zwraca status zapytania.
Adres bazowy do API:
GET
https://chmurz.sewada.com/api/v1
Dane zwracane:
(number) status - status zapytania 200, 404, 403, 500, 507
(string) msg - opis błędu
(number) code - kod błędu
(object) result - obiekt zwracany w przypadku braku błędów
100 - wymagany klucz API
101 - błędny klucz API
102 - brak przestrzeni dyskowej
103 - brak parametru w url
404 - URL nie istnieje
500 - wystąpił błąd po stronie serwera
(string) msg - opis błędu
(number) code - kod błędu
(object) result - obiekt zwracany w przypadku braku błędów
100 - wymagany klucz API
101 - błędny klucz API
102 - brak przestrzeni dyskowej
103 - brak parametru w url
404 - URL nie istnieje
500 - wystąpił błąd po stronie serwera
Pobieranie url do uploadu
Metoda zwraca url, id sesji oraz date jej wygaśnięcia.
GET
https://chmurz.sewada.com/api/v1/upload/get?key=TWOJ_KLUCZ_API
Parametry wejściowe (query):
(string) key - klucz api z panelu
Dane zwracane (result):
(string) sessionId - id sesji
(string) expireAt - data wygaśnięcia sesji w formacie ISO 8601
(string) uploadUrl - adres url na który należy wysłać plik
(string) expireAt - data wygaśnięcia sesji w formacie ISO 8601
(string) uploadUrl - adres url na który należy wysłać plik
Upload pliku na serwer
Możliwy jest jedynie upload metodą POST jako "multipart/form-data". Maksymalny rozmiar pojedyńczego pliku to 20 GB. Serwer przerwie połączenie w przypadku przekroczenia limitu, braku id sesji lub innego błędu.
POST
Zwrócony URL w poprzedniej metodzie.
Parametry wejściowe (form-data):
(blob) file - input type="file"
Dane zwracane (result):
(string) code - id pliku
(string) url - link do pliku
(string) url - link do pliku
Pobieranie informacji o plikach
Metoda zwraca nazwę, rozmiar, typ MIME, liczbę pobrań, date uploadu oraz status pliku
GET
https://chmurz.sewada.com/api/v1/file/get?key=TWOJ_KLUCZ_API&ids=ID_PLIKU,ID_PLIKU...
Parametry wejściowe (query):
(string) key - klucz api z panelu
(string) ids - id plików po przecinu maksymalnie 50
(string) ids - id plików po przecinu maksymalnie 50
Dane zwracane (result):
(string) name - nazwa pliku
(number) size - rozmiar pliku w Bajtach
(string) mimetype - typ MIME
(number) downloads - liczba pobrań
(string) uploadedAt - data uploadu pliku na serwer w formacie ISO 8601
(string) status - status pliku ready, deleted
(number) size - rozmiar pliku w Bajtach
(string) mimetype - typ MIME
(number) downloads - liczba pobrań
(string) uploadedAt - data uploadu pliku na serwer w formacie ISO 8601
(string) status - status pliku ready, deleted