Přeskočit na obsah

Reference vývojářského API

Developer API akousa.net je RESTful JSON API, které vám umožňuje zapojit naše nástroje, hry, cenová data, zprávy, analýzu webů a stav služeb přímo do vlastních aplikací. Rozhraní nabízí 81 endpointů v 17 skupinách, takže můžete automatizovat téměř cokoli, co je na webu dostupné.

Naposledy aktualizováno: 11. října 2026

Co je Developer API?

Developer API akousa.net je RESTful JSON API, které vám umožňuje zapojit naše nástroje, hry, cenová data, zprávy, analýzu webů a stav služeb přímo do vlastních aplikací. Rozhraní nabízí 81 endpointů v 17 skupinách, takže můžete automatizovat téměř cokoli, co je na webu dostupné.

Ověřte se jediným API klíčem, odesílejte standardní HTTP požadavky a přijímejte předvídatelné JSON odpovědi. Kompletní OpenAPI 3.1 specifikace a interaktivní ukázky kódu v 8 jazycích činí integraci rychlou.

Základní URL

https://akousa.net/api/v1

Všechny API endpointy jsou dostupné přes HTTPS z následující základní URL:

Verzování

v1 · X-API-Version: 1.2.0

API je verzováno prostřednictvím cesty v URL. Aktuální verze je v1. Všechny odpovědi obsahují hlavičku X-API-Version. Zastaralé koncové body oznamují své odstranění hlavičkami Deprecation a Sunset (RFC 8594). Zpětně nekompatibilní změny povedou k vydání nové verze.

Příklad rychlého startu

Začněte ve 3 krocích. Vytvořte API Key, odešlete požadavek, získejte výsledek.

Požadavekcurl
curl -X POST https://akousa.net/api/v1/tools/base64 \
  -H "Authorization: Bearer ak_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":"Hello, World!","mode":"encode"}'
Odpověďjson
{
  "output": "SGVsbG8sIFdvcmxkIQ==",
  "tool": "base64",
  "mode": "encode",
  "executionMs": 1
}

Ověřování

Příklad požadavku s autentizací

Authorization: Bearer ak_YOUR_API_KEY

API klíče vždy začínají předponou 'ak_'.

Bez autentizaceGET /api/v1/toolsGET /api/v1/openapi.jsonPOST /api/v1/sandboxGET /api/v1/servicesGET /api/v1/workflow/galleryGET /api/v1/workflow/gallery/{id}

Skupiny API endpointů

API je rozděleno do 17 logických skupin, které pokrývají nástroje, dávkové a řetězené operace, analytiku, správu klíčů a předplatného, webhooky, předvolby, data v reálném čase a síťová data, finanční a užitková data, infrastrukturu a specifikaci OpenAPI. Každá skupina sdružuje související endpointy, takže snadno najdete přesně to, co potřebujete.

81 endpointů

Nástroje2
Dávkování a řetězení2
Analytika a využití4
API klíče4
Předplatné a fakturace2
Webhooky5
Předvolby5
Data — reálný čas7
Data — síť7
Data — finance3
Data — nástroje1
Infrastruktura2
Analyzátor webových stránek14
Plánovače5
Specifikace1
Pracovní postupy15
Nastavení2

Formát odpovědi

API používá standardní HTTP stavové kódy. Chybové odpovědi obsahují tělo JSON s polem error popisujícím problém.

Odpověďjson
{
  "output": "SGVsbG8sIFdvcmxkIQ==",
  "tool": "base64",
  "mode": "encode",
  "executionMs": 1
}
Formát chybové odpovědijson
{
  "ok": false,
  "error": "Invalid API key",
  "code": "UNAUTHORIZED",
  "status": 401
}
StavVýznam
200Úspěch — nástroj spuštěn, výstup vrácen
400Chybný požadavek — neplatný vstup, režim nebo konfigurace
401Neautorizováno — chybějící nebo chybný API Key
403Zakázáno — neplatný nebo odvolaný API Key
404Nenalezeno — slug nástroje není dostupný
413Příliš velký obsah — vstup překračuje 100KB
422Nezpracovatelné — spuštění nástroje selhalo (viz chybová zpráva)
429Překročen limit — denní kvóta nebo okamžitý limit vyčerpán

Limity požadavků

Limity požadavků závisí na vašem tarifu. Každá odpověď obsahuje hlavičky X-RateLimit-Limit, X-RateLimit-Remaining a X-RateLimit-Reset, takže můžete požadavky proaktivně omezovat. Při překročení limitu se vrátí HTTP 429 s hlavičkou Retry-After udávající, kdy to zkusit znovu.

Bezplatná úroveň

Denní limit
50
pož/sek
2
API klíče
1

Pro úroveň

Denní limit
100 000
pož/sek
50
API klíče
50
Hlavičky omezení rychlosti
X-RateLimit-LimitDenní limit
X-RateLimit-RemainingZbývající požadavky pro aktuální den
X-RateLimit-ResetUTC časová razítka obnovení kvóty
Retry-AfterPřekročen limit — denní kvóta nebo okamžitý limit vyčerpán

SDK a integrace

Importujte OpenAPI 3.1 specifikaci z /api/v1/openapi.json do Postman, Swagger UI, Insomnia nebo jakéhokoli kompatibilního klienta a prozkoumejte endpointy a automaticky vygenerujte klientské knihovny. Interaktivní ukázky kódu v cURL, JavaScript, Python, Go, PHP, Ruby, Java a C# jsou k dispozici na stránce každého endpointu.

Stáhnout OpenAPI specifikaci