API

Podłącz FileShark do JDownloadera, własnych skryptów albo bota. Sprawdzaj linki, odczytuj stan konta i pobieraj bezpośrednie linki do plików, wszystko w prostym JSON-ie.

Wygeneruj klucz

Wejdź w „Bezpieczeństwo konta” i kliknij „Wygeneruj klucz API”. Klucz zobaczysz tylko raz, więc zapisz go w bezpiecznym miejscu.

Dodaj go do swojego narzędzia

W JDownloaderze wpisz e-mail jako nazwę użytkownika, a klucz jako hasło. We własnych skryptach wysyłaj go w nagłówku Authorization.

Pobieraj

Z premium dostajesz bezpośrednie linki z pełną prędkością. Sprawdzanie linków działa bez klucza i bez konta.

Opis zapytań

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://www.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://www.fileshark.pl/api/v1/account

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

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

Informacje o pliku: status, nazwa i rozmiar.

GEThttps://www.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://www.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.

Najczęstsze pytania

Czy do API potrzebuję premium?

Do sprawdzania linków i odczytu stanu konta nie. Linki do pobierania przez API są dla kont premium, bo omijają odliczanie i captchę.

Czy mój klucz API jest bezpieczny?

Przechowujemy tylko jego odcisk, więc nawet my nie możemy go odczytać. Traktuj go jak hasło i nie wklejaj na forach. Jeśli wycieknie, wygeneruj nowy, a stary od razu przestanie działać.

Jakie są limity?

Do 120 zapytań na minutę na klucz i 300 na minutę z jednego adresu IP. Pobrania przez API zużywają ten sam limit dzienny albo transfer co pobrania w przeglądarce.

Czy mogę wysyłać pliki przez API?

Jeszcze nie. Do wysyłania hurtem użyj konta FTP z ustawień konta albo po prostu przeciągnij cały folder na pole wysyłania.

Nie ma tu odpowiedzi na Twoje pytanie? Napisz do nas