Skip to content
Veřejné API · v1

Veřejné API Pokékipe

Free competitive Pokémon analytika, odvozená z měsíčních usage statistik Smogonu a refreshovaná každý měsíc. Pro běžné použití není potřeba účet; vygeneruj si osobní klíč v Nastavení účtu pro zvednutí rate-limit stropu pro bulk pulls.

QuickstartOtevřít referenci

  • Endpointy

    100+

  • Formáty

    30+

  • Refresh

    Měsíčně

  • Auth

    Volitelné

  • Licence

    CC BY 4.0

Proč to existuje

Co toto API je a co není

Čtyři věci, které je dobré vědět, než napíšeš jediný řádek kódu proti /api/v1/.

Co toto API je

Read-only JSON surface nad světovými daty competitive Pokémon. Zeptej se „jaká je meta v Gen 9 OU na 1500+ ELO tenhle měsíc?“ nebo „kdo counteroval tohohle Pokémona v top cutu tohohle tournamentu?“ a dostaneš odpověď jedním voláním se stabilními, zdokumentovanými tvary.

Odkud data pocházejí

Měsíční battle logy Smogonu (veřejný chaos JSON), oficiální tournament feedy (Pokémon Company, VGC, Smogon Tour) a komunitní zdroje jako Limitless TCG pro community-run akce. Pokékipe nad tím provozuje vlastní ingestion, normalizaci a enrichment pipeline a pak re-exposes čistý výsledek.

Co toto API není

Není to live bridge na Pokémon Showdown, není to battle simulátor, není to endpoint damage calculatoru, není to teambuilding engine. Tyhle nástroje žijí na webu. API je datová vrstva, na které sedí.

Credit upstreamu

Credit tam, kam patří. Smogon, exportéři chaos-format JSONu a komunita hráčů, co každý měsíc hraje hry, jsou důvodem, proč tenhle dataset existuje. Pokékipe ho dělá dotazovatelným; nevlastní podkladová data.

Začni

Tvoje první volání, za 30 sekund

Tři copy-paste příklady, které stáhnou katalog formátů. Žádný API klíč, žádný setup, žádný signup. Vyber svůj language tab, paste, run.

curl -s https://pokekipe.com/api/v1/formats \
  | jq '.[0:3]'

Nahraď cestu jakýmkoliv endpointem ze seznamu v referenci níže. První volání by se mělo vrátit do sekundy na warm cache.

Autentizace

Autentizace a rate limity

Anonymní volání fungují pro běžné použití. Osobní klíč (zdarma, vygeneruješ si ho v nastavení účtu) zvedne strop rate-limitu pro analytiky a tvůrce nástrojů, kteří tahají data ve velkém. Klíče neodemykají nové endpointy; jen zvedají strop.

Anonymní, bez klíče

Výchozí

Volej bez jakékoliv hlavičky. Bucket je klíčovaný na tvoji IP, takže malý script nebo LLM agent dělající pár requestů za session nikdy nenarazí na limit.

  • Žádný účet, žádný signup, žádná hlavička.
  • Per-IP bucket, vhodný pro ad-hoc scripty a LLM agent tool-use.
  • Trefíš 429, pokud držíš bulk pulls; přepni na osobní klíč.

za minutu

60

za den

5,000

Autentizovaný, s osobním klíčem

Doporučeno pro bulk

Pošli klíč jako X-API-Key (nebo Authorization: Bearer pk_live_…). Anonymní volání fungují dál souběžně; klíč jen zvedne strop, neodemyká nové endpointy.

  • Per-user bucket: změny tvojí IP nevynulují počet.
  • Vyšší stropy na každém per-route limitu.
  • Až 5 aktivních klíčů na účet, kdykoliv revokovatelné.

za minutu

600

za den

100,000

Vygenerovat API klíč

Hlavičky v každé odpovědi

Každá úspěšná odpověď nese rate-limit hlavičky níže, takže si tvůj klient může sám držet tempo bez retries. Přečti je jednou na odpověď a zpomal v momentě, kdy Remaining klesne na pár requestů, ne na nulu.

HlavičkaVýznam
X-RateLimit-TierPod jaký tier spadáš: anonymní (bez klíče) nebo autentizovaný (rozparsovaný JWT nebo API klíč).
X-RateLimit-Limit-MinMinutový strop pro tvůj tier (60 anonymní, 600 autentizovaný).
X-RateLimit-Limit-DayDenní strop pro tvůj tier (5 000 anonymní, 100 000 autentizovaný).
X-RateLimit-Remaining-MinZbývající volání v aktuálním minutovém okně. Zpomal, když se to blíží nule.
X-RateLimit-Remaining-DayZbývající volání v aktuálním denním okně. Resetuje se každý den ve stejnou minutu wall-clocku.
Retry-AfterPosílá se jen u 429. Počkej tolik sekund, než to zkusíš znovu, obvykle pod 60 pro minutové okno.

Chyby

Chyby, se kterými se můžeš setkat

Standardní HTTP status kódy. Tělo je vždy JSON s polem „detail“ popisujícím, co se pokazilo. Ber 4xx jako problém kontraktu (tvůj request) a 5xx jako náš problém (retry s backoffem).

200

OK

OK. Tělo je JSON payload zdokumentovaný v referenci. Prázdná pole znamenají „žádné řádky“, ne „chybí“, ber je jako data, ne jako chybu.

304

Not Modified

Not Modified. Cache hlavičky byly ověřené. Použij cachované tělo, není potřeba znovu parsovat. Vrací se automaticky, když pošleš If-None-Match nebo If-Modified-Since.

400

Bad Request

Bad Request. Query parametr nebo tvar těla je špatně. Detail hlášky pojmenuje konkrétní pole. Neopakuj request bez opravy vstupu.

401

Unauthorized

Unauthorized. Request potřeboval API klíč nebo session a nedostal ani jedno, nebo byly přihlašovací údaje neplatné/zrušené. Nepal dál, vygeneruj nový klíč.

404

Not Found

Not Found. Cesta nebo zdroj neexistuje. U routes per-Pokémon to často znamená, že formát zatím nemá usage data pro daného Pokémona, ne překlep z tvé strany.

429

Too Many Requests

Too Many Requests. Narazil jsi na strop rate-limitu. Přečti si Retry-After a počkej, exponenciální backoff je slušnost, ale málokdy potřeba, protože okno je krátké.

500

Server Error

Internal Server Error. Něco nám prasklo na naší straně. Zkus to za pár sekund znovu; pokud to přetrvává, napiš nám na Discordu s URL requestu.

503

Service Unavailable

Service Unavailable. Buď deployujeme, nebo jsme dočasně přetížení. Zkus to znovu s backoffem. Status updaty postujeme na komunitním Discordu.

Základní pravidla

Podmínky použití

Čtyři základní pravidla. Přečti jednou, ušetři budoucímu sobě ping na Discordu.

Credit upstreamu

Při redistribuci nebo republikaci je vyžadována atribuce. Uveď Pokékipe (link na https://pokekipe.com) a Smogon za podkladový chaos JSON, který každý měsíc publikují.

Best-effort, žádné SLA

Best-effort, žádné SLA. Data jsou servírována „as is“ bez záruky uptime. Cachuj agresivně a degraduj gracefully, když je endpoint pomalý nebo vrátí 429.

Verzování

Schémata pod /api/v1/ zůstávají zpětně kompatibilní v rámci lifecyclu v1. Breaking changes jdou do /api/v2/ s předchozím oznámením na Discordu a sunset hlavičkou na deprecated cestě.

Komerční použití

Komerční použití je povoleno pod CC BY 4.0. Pokud nad tímhle API něco postavíš, rádi o tom uslyšíme na komunitním Discordu.

Reference · OpenAPI 3Live, tři panely

Projdi si každý endpoint, všechno na jednom místě

Projdi si každý endpoint s popisy, tabulkami parametrů, request a response schématy a code samples v curl, JavaScriptu a Pythonu. Prohledej celé API v jednom poli, deep-link na jakoukoliv operaci, sdílej URL.

  • 100+ endpointů
  • ·
  • 3-pane navigace, content, samples
  • ·
  • fulltextové hledání
  • ·
  • live request samples
Otevřít plnou referenciNebo si stáhni raw OpenAPI 3 spec