GET
/api/v1/posts
Vrací seznam postů. Podporuje stránkování (limit, offset), výběr polí (fields), rozšíření (include) a filtry.
Příklad
GET https://api.pornokomiks.cz/api/v1/posts?fields=id,name,image,url&include=tags&limit=10
Odpověď
{
"ok": true,
"data": [ ... ],
"meta": { "limit": 10, "offset": 0, "total": 170 }
}
Parametry
fields
CSV seznam polí: id,name,image,url,created
Default: id,name,image,url
include
CSV rozšíření: tags, characters
limit / offset
Stránkování (limit 1..MAX, offset 0..)
sort
created, name, id.
Sestupně: -created
Filtry (kombinovatelné)
name / name_not
Obsahuje / neobsahuje text v názvu (LIKE / NOT LIKE)
tags / tags_all / tags_not
tags = alespoň jeden (ANY),
tags_all = všechny (ALL),
tags_not = žádný z nich (NONE)
characters / characters_all / characters_not
Stejná logika jako tags
user / user_not
Autor postu (u vás je sloupec p.user)
Cheat-sheet
| Parametr | Význam |
|---|---|
| tags | musí mít alespoň jeden zadaný tag |
| tags_all | musí mít všechny zadané tagy |
| tags_not | nesmí mít žádný zadaný tag |
| user | autor = hodnota |
| user_not | autor ≠ hodnota |
Příklady dotazů
Tagy (ANY)
/api/v1/posts?include=tags&tags=Furry,nevěra
Tagy (ALL)
/api/v1/posts?include=tags&tags_all=Incest,mládí
Bez tagu
/api/v1/posts?include=tags&tags_not=Furry
Autor + název
/api/v1/posts?include=tags&user=admin&name=Pie
Chyby
400 — Bad Request
{
"ok": false,
"error": { "code": "INVALID_PARAM", "message": "Unknown parameter ..." }
}
405 — Method Not Allowed
{
"ok": false,
"error": { "code": "METHOD_NOT_ALLOWED", "message": "Only GET is supported." }
}
Pokud se objeví CORS chyba v prohlížeči, server musí posílat hlavičku
Access-Control-Allow-Origin: *.
▶ Vyzkoušet API (Try it)
Dotaz se posílá přímo na api.pornokomiks.cz
Tip: odděluj parametry &, seznamy čárkou.
Výsledná URL
Odpověď
Status: —
Klikni na „Odeslat dotaz“.