Tryb API¶

Nieinteraktywne API JSON dla skryptów, automatyzacji i integracji z innymi narzędziami.

Przegląd¶

Tryb API zapewnia wyjście JSON dla wszystkich operacji, ułatwiając: - Integrację ze skryptami - Automatyzację przepływów pracy - Tworzenie niestandardowych interfejsów - Łączenie z innymi narzędziami

Wszystkie polecenia API obsługują wybór dostawcy za pomocą opcji --provider (lub -p). Pozwala to wybrać, którego źródła anime użyć dla każdej operacji.

Wybór dostawcy¶

Dostępni dostawcy¶

Użyj polecenia providers, aby zobaczyć wszystkich dostępnych dostawców:

weeb-cli api providers

Odpowiedź:

[
  {
    "name": "animecix",
    "lang": "tr",
    "region": "TR",
    "class": "AnimecixProvider",
    "disabled": false
  },
  {
    "name": "hianime",
    "lang": "en",
    "region": "US",
    "class": "HiAnimeProvider",
    "disabled": false
  },
  {
    "name": "aniworld",
    "lang": "de",
    "region": "DE",
    "class": "AniWorldProvider",
    "disabled": false
  },
  {
    "name": "docchi",
    "lang": "pl",
    "region": "PL",
    "class": "DocchiProvider",
    "disabled": false
  }
]

Kategorie dostawców¶

Dostawcy tureccy: - animecix - Domyślny turecki dostawca - turkanime - Alternatywne tureckie źródło - anizle - Tureckie streamowanie anime - weeb - Tureckie źródło anime

Dostawcy angielscy: - hianime - Wysokiej jakości angielskie anime - allanime - Kompleksowe angielskie źródło

Dostawcy niemieccy: - aniworld - Niemieckie streamowanie anime

Dostawcy polscy: - docchi - Polskie źródło anime

Używanie dostawców¶

Wszystkie polecenia akceptują opcję --provider lub -p:

# Wyszukiwanie z określonym dostawcą
weeb-cli api search "Naruto" --provider hianime

# Pobieranie odcinków z tureckiego źródła
weeb-cli api episodes "anime-id" --provider turkanime

# Pobieranie z niemieckiego dostawcy
weeb-cli api download "anime-id" -s 1 -e 1 --provider aniworld

Domyślny dostawca: Jeśli --provider nie jest określony, domyślnie używany jest animecix.

Podstawowe użycie¶

Wszystkie polecenia API są zgodne z tym wzorcem:

weeb-cli api [POLECENIE] [ARGUMENTY] [OPCJE]

Wyjście jest zawsze prawidłowym JSON.

Polecenia¶

providers¶

Wyświetl wszystkich dostępnych dostawców z metadanymi.

weeb-cli api providers

Odpowiedź:

[
  {
    "name": "animecix",
    "lang": "tr",
    "region": "TR",
    "class": "AnimecixProvider"
  },
  {
    "name": "hianime",
    "lang": "en",
    "region": "US",
    "class": "HiAnimeProvider"
  }
]

search¶

Wyszukaj anime u dostawców.

weeb-cli api search "nazwa anime" --provider animecix

Odpowiedź:

[
  {
    "id": "anime-slug",
    "title": "Tytuł anime",
    "type": "series",
    "cover": "https://cover-url.jpg",
    "year": 2024
  }
]

episodes¶

Pobierz listę odcinków dla anime.

weeb-cli api episodes "anime-id" --provider animecix

Opcjonalnie: Filtruj według sezonu

weeb-cli api episodes "anime-id" --season 2 --provider animecix

Odpowiedź:

[
  {
    "id": "episode-id",
    "number": 1,
    "title": "Tytuł odcinka",
    "season": 1,
    "url": "https://episode-url"
  }
]

streams¶

Pobierz adresy URL strumieni dla odcinka.

weeb-cli api streams "anime-id" "episode-id" --provider animecix

Odpowiedź:

[
  {
    "url": "https://stream-url.m3u8",
    "quality": "1080p",
    "server": "megacloud",
    "headers": {
      "Referer": "https://..."
    },
    "subtitles": null
  }
]

Obsługa błędów¶

Odpowiedź błędu¶

Błędy są zwracane jako JSON do stderr:

{
  "error": "Nie znaleziono dostawcy: nieprawidłowy-dostawca"
}

Kod wyjścia jest niezerowy w przypadku błędu.

Sprawdzanie błędów¶

if weeb-cli api search "anime" --provider nieprawidłowy 2>/dev/null; then
    echo "Sukces"
else
    echo "Niepowodzenie"
fi

Przykłady integracji¶

Skrypt Python¶

import subprocess
import json

def search_anime(query, provider="animecix"):
    result = subprocess.run(
        ["weeb-cli", "api", "search", query, "--provider", provider],
        capture_output=True,
        text=True
    )

    if result.returncode == 0:
        return json.loads(result.stdout)
    else:
        error = json.loads(result.stderr)
        raise Exception(error["error"])

# Użycie
results = search_anime("One Piece", "hianime")
for anime in results:
    print(f"{anime['title']} ({anime['year']})")

Skrypt Bash¶

#!/bin/bash

PROVIDER="animecix"
QUERY="Naruto"

# Wyszukaj
results=$(weeb-cli api search "$QUERY" --provider "$PROVIDER")

# Parsuj za pomocą jq
echo "$results" | jq -r '.[] | "\(.title) - \(.year)"'

# Pobierz ID pierwszego wyniku
anime_id=$(echo "$results" | jq -r '.[0].id')

# Pobierz odcinki
episodes=$(weeb-cli api episodes "$anime_id" --provider "$PROVIDER")
echo "$episodes" | jq -r '.[] | "Odcinek \(.number): \(.title)"'

Skrypt Node.js¶

const { exec } = require('child_process');
const util = require('util');
const execPromise = util.promisify(exec);

async function searchAnime(query, provider = 'animecix') {
    const cmd = `weeb-cli api search "${query}" --provider ${provider}`;
    const { stdout } = await execPromise(cmd);
    return JSON.parse(stdout);
}

// Użycie
searchAnime('One Piece', 'hianime')
    .then(results => {
        results.forEach(anime => {
            console.log(`${anime.title} (${anime.year})`);
        });
    })
    .catch(console.error);

Zaawansowane użycie¶

Przekierowywanie wyników¶

# Wyszukaj i filtruj za pomocą jq
weeb-cli api search "anime" --provider animecix | \
    jq '.[] | select(.year >= 2020)'

# Pobierz wszystkie odcinki i policz
weeb-cli api episodes "anime-id" --provider animecix | \
    jq 'length'

# Pobierz strumień najlepszej jakości
weeb-cli api streams "anime-id" "ep-id" --provider animecix | \
    jq -r '.[0].url'

Łączenie poleceń¶

# Wyszukaj, pobierz pierwszy wynik, pobierz odcinki
ANIME_ID=$(weeb-cli api search "Naruto" --provider animecix | jq -r '.[0].id')
weeb-cli api episodes "$ANIME_ID" --provider animecix

Obsługa błędów¶

# Przechwytuj błędy
if ! output=$(weeb-cli api search "anime" --provider nieprawidłowy 2>&1); then
    echo "Wystąpił błąd: $output"
    exit 1
fi

Wydajność¶

Buforowanie¶

Tryb API używa tej samej pamięci podręcznej co tryb interaktywny: - Wyniki wyszukiwania buforowane przez 1 godzinę - Szczegóły buforowane przez 6 godzin - Strumienie nie są buforowane

Tryb bezgłowy¶

Tryb API działa w trybie bezgłowym: - Nie ładowane zależności TUI - Szybszy start - Mniejsze zużycie pamięci

Ograniczenia¶

Brak funkcji interaktywnych¶

Tryb API nie obsługuje: - Menu i monitów - Pasków postępu - Wprowadzania użytkownika - Kolorowego wyjścia

Brak zarządzania stanem¶

Każde polecenie jest niezależne: - Brak stanu sesji - Brak aktualizacji historii oglądania - Brak śledzenia postępu

Użyj trybu interaktywnego dla tych funkcji.

Najlepsze praktyki¶

Zawsze jawnie określaj dostawcę
Prawidłowo obsługuj błędy
Parsuj JSON odpowiednimi narzędziami (jq, Python json)
Buforuj wyniki, gdy to możliwe
Używaj odpowiednich limitów czasu

Następne kroki¶

Dokumentacja poleceń: Wszystkie polecenia CLI
Tryb Serve: Serwer Torznab
Rozwój: Rozwój API