API

API pozwala menedżerom pobierania (np. JDownloader) i Twoim własnym narzędziom korzystać z Twojego konta. Wszystkie odpowiedzi są w formacie JSON.

Klucz API

Wygeneruj klucz w ustawieniach bezpieczeństwa konta. Wysyłaj go w nagłówku Authorization: Bearer KEY albo jako parametr ?apikey=KEY.

JDownloader: przy dodawaniu konta wpisz e-mail jako nazwę użytkownika, a klucz API jako hasło.

GET / POSThttps://fileshark.pl/api/v1/check?links=LINK1,LINK2

Sprawdza do 500 linków. Nie wymaga klucza API. Zwraca status (online, offline, removed), nazwę i rozmiar.

GEThttps://fileshark.pl/api/v1/account

Twoje konto: status premium, data końca premium, pozostały transfer i limit dzienny (w bajtach).

GEThttps://fileshark.pl/api/v1/file/ID

Informacje o pliku: status, nazwa i rozmiar.

GEThttps://fileshark.pl/api/v1/download/ID

Link do pobrania (ważny 24 godziny, z Twojego adresu IP). Tylko premium. Liczy się jak pobranie i zużywa limit dzienny albo transfer.

Przykład

curl -H "Authorization: Bearer fs_…" https://fileshark.pl/api/v1/download/oLXIgHFHCnXu

{
  "id": "oLXIgHFHCnXu",
  "name": "file.zip",
  "size": 6436791,
  "url": "https://dl.fileshark.pl/…"
}

Błędy zwracają status HTTP (401, 403, 404, 429) i treść JSON z polami error i message. Limit: 120 zapytań na minutę na klucz.