API

Հոսքը տրվում է նույն պատասխանով, որը կարդում է հենց էջը։ Բանալի պետք չէ, հարցումները միայն կարդալու համար են։

Հասցեhttps://pulse.arevian.studio

GET/api/news

Սյուժեների հոսքը ընտրված պատուհանի համար։ Ճիշտ այն, ինչ ցույց է տալիս գլխավոր էջը։

Պարամետրեր

Անուն	Արժեքներ	Ինչ է անում
`window`	30m · 3h · 24h · 7d · 30d	Ինչ ժամկետով հաշվել։ Լռելյայն՝ 24h։
`topic`	tech, ai, science, design, business, politics, incidents, society, culture, sport, studio	Թեմաները՝ ստորակետով։ Առանց պարամետրի՝ բոլորը։
`lang`	ru · en · hy	Աղբյուրների լեզուն, նույնպես ստորակետով։
`geo`	armenia · russia · world	Իրադարձության աշխարհագրությունը՝ թեմայից անկախ առանցք։
`media`	rss · telegram	Որտեղից է սյուժեն՝ խմբագրության հոսք թե Telegram-ալիք։
`from, to`	ISO-8601	Ձեր միջակայքը՝ պատուհանի փոխարեն։
`limit, offset`	թիվ	Արդյունքների էջը։ limit-ը՝ առավելագույնը 50։

GET/api/news/search

Որոնում սյուժեներով։ Երկու նիշից քիչ հարցումը տալիս է դատարկ պատասխան, ոչ թե սխալ։

Անուն	Արժեքներ	Ինչ է անում
`q`	տող	Հարցումը։ 80 նիշից ավելին կտրվում է։

curl "https://pulse.arevian.studio/api/news?window=24h&topic=tech,ai&lang=en&limit=10"

items — սյուժեների ցանկը՝ վերնագիր, ամփոփում, թեմաներ, առաջին հրապարակման ժամ, անկախ աղբյուրների թիվ և հաշիվ։
has_more — կա՞ արդյոք հաջորդ էջը նույն զտիչներով։
degraded: true — «չկարողացանք հաշվել», ոչ թե «ոչինչ չգտնվեց»։ Այս դրոշի կողքի դատարկ ցանկը պատճառ չէ ջնջելու արդեն ցուցադրվածը։

Պատասխանը քեշավորվում է մեկ րոպե — worker-ը հոսքը վերահաշվում է յուրաքանչյուր հինգ րոպեն մեկ։
Բանալի պետք չէ, բայց հասցեի սահմանաչափ կա. հոսքը սպասարկում է բոլոր ընթերցողներին, ոչ թե մեկ հաճախորդի։
Տեքստերը պատկանում են խմբագրություններին։ Պատասխանում կա հղում սկզբնաղբյուրին — հենց այնտեղ պետք է գնա ընթերցողը։