Մենյու
ՄուտքԱնձնական էջ
Դեպի ժապավեն

API

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

Այս էջը չի գործարկում օրինակները։ Պատճենեք ամբողջ օրինակը կամ ընտրեք կոդի բլոկը՝ հորիզոնական ոլորելու համար։

Հիմնական URL

https://pulse.arevian.studio

Հոսք

GET/api/news

Սյուժեներ՝ ընտրված պատուհանի վարկանիշով։ Ամսաթվերի սահմանների դեպքում կիրառվում է ժամանակագրական կարգը։

Պարամետրեր

Հոսքի բոլոր պարամետրերը ոչ պարտադիր են։ Առանց դրանց կիրառվում են լռելյայն արժեքները։

Պարամետրեր — /api/news
ԱնունԱրժեքներՆկարագրություն
window30m · 3h · 24h · 7d · 30dՎարկանիշի պատուհանը։ Լռելյայն՝ 24h։
topicai, tech, science, space, studioԹեմաները՝ ստորակետով․ առանց պարամետրի՝ բոլոր չորսը։ studio-ն Arevian-ի սեփական նյութերն են։
langru · en · hyԱղբյուրների լեզուները՝ ստորակետով։
mediarss · telegramԽմբագրությունների հոսքեր կամ Telegram-ալիքներ՝ ստորակետով։
from, toISO 8601 · 2026-10-13T00:00:00ZԱմսաթվերի ոչ պարտադիր սահմաններ՝ ժամային գոտով։ Ամսաթվի սահմանը արդյունքները դասավորում է ժամանակագրական կարգով։
word2–40 նիշ · մինչև 20 բառՍտորակետով բաժանված բառերը ընդլայնում են թեմաների զտիչը․ համընկնող սյուժեն կարող է գալ, նույնիսկ եթե նրա թեման ընտրված չէ։
limit1–60Արդյունքների քանակը մեկ էջում։ Լռելյայն՝ 25։
offset0–300Բաց թողնվող արդյունքների քանակը։ Լռելյայն՝ 0։ Հաջորդ էջի համար ավելացրեք էջի չափով․ version-ի փոփոխության դեպքում հեռացրեք կրկնությունները ըստ id-ի։

  • window

    Արժեքներ
    30m · 3h · 24h · 7d · 30d
    Նկարագրություն
    Վարկանիշի պատուհանը։ Լռելյայն՝ 24h։

  • topic

    Արժեքներ
    ai, tech, science, space, studio
    Նկարագրություն
    Թեմաները՝ ստորակետով․ առանց պարամետրի՝ բոլոր չորսը։ studio-ն Arevian-ի սեփական նյութերն են։

  • lang

    Արժեքներ
    ru · en · hy
    Նկարագրություն
    Աղբյուրների լեզուները՝ ստորակետով։

  • media

    Արժեքներ
    rss · telegram
    Նկարագրություն
    Խմբագրությունների հոսքեր կամ Telegram-ալիքներ՝ ստորակետով։

  • from, to

    Արժեքներ
    ISO 8601 · 2026-10-13T00:00:00Z
    Նկարագրություն
    Ամսաթվերի ոչ պարտադիր սահմաններ՝ ժամային գոտով։ Ամսաթվի սահմանը արդյունքները դասավորում է ժամանակագրական կարգով։

  • word

    Արժեքներ
    2–40 նիշ · մինչև 20 բառ
    Նկարագրություն
    Ստորակետով բաժանված բառերը ընդլայնում են թեմաների զտիչը․ համընկնող սյուժեն կարող է գալ, նույնիսկ եթե նրա թեման ընտրված չէ։

  • limit

    Արժեքներ
    1–60
    Նկարագրություն
    Արդյունքների քանակը մեկ էջում։ Լռելյայն՝ 25։

  • offset

    Արժեքներ
    0–300
    Նկարագրություն
    Բաց թողնվող արդյունքների քանակը։ Լռելյայն՝ 0։ Հաջորդ էջի համար ավելացրեք էջի չափով․ version-ի փոփոխության դեպքում հեռացրեք կրկնությունները ըստ id-ի։

Հոսք · cURL

curl --get \
  "https://pulse.arevian.studio/api/news" \
  --data-urlencode "window=24h" \
  --data-urlencode "topic=tech,ai" \
  --data-urlencode "lang=en" \
  --data-urlencode "limit=10"

Հոսք · URL

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

Պատասխանի ձևաչափը

Օրինակները ցույց են տալիս պատասխանի կառուցվածքը, ոչ թե ընթացիկ տվյալները։ Դատարկ items զանգվածը կարող է լինել հաջող պատասխան։

  • items — սյուժեներ՝ id, title, summary, թեմաներով, հրապարակումների ժամերով, աղբյուրների հղումներով և հաշվով։ Որոշ դաշտեր կարող են լինել null։
  • window, generated_at և offset-ը նկարագրում են հոսքի պատասխանը․ has_more-ը ցույց է տալիս նույն զտիչներով հաջորդ էջի առկայությունը։
  • version-ը վերջին վերահաշվարկի նշումն է, ոչ թե հարցման պարամետր։ Էջերի միջև վարկանիշը կարող է փոխվել․ համեմատեք տարբերակները և հեռացրեք կրկնությունները ըստ id-ի։
  • Որոնումը վերադարձնում է query և items՝ առանց has_more-ի և version-ի։
GET /api/news · JSON

GET /api/news · JSON

{
  "window": "24h",
  "generated_at": "2026-10-13T10:00:00.000Z",
  "version": 0,
  "offset": 0,
  "has_more": false,
  "items": []
}

GET /api/news/search · JSON

GET /api/news/search · JSON

{
  "query": "Mars",
  "items": []
}

Սխալներ և դատարկ արդյունքներ

Հոսքի սերվերի խափանման կամ պարամետրերի մերժման դեպքում հանրային հասցեն վերադարձնում է HTTP 200՝ degraded: true դրոշով։ HTTP կարգավիճակից բացի ստուգեք նաև այդ դրոշը․ պահեք վերջին հաջող տվյալները և կրկնելուց առաջ ստուգեք պարամետրերը։

GET /api/news · HTTP 200

{
  "items": [],
  "degraded": true
}

Որոնումը վերադարձնում է HTTP 200՝ query և items դաշտերով։ Հոսքի սերվերի խափանման դեպքում ավելանում է degraded: true, և պատասխանը չի քեշավորվում։ Առանց այդ դրոշի դատարկ items-ը հաջող դատարկ արդյունք է․ պահեք միայն նույն հարցման նախկին արդյունքները և կրկնեք ընթերցումը ավելի ուշ։

GET /api/news/search · HTTP 200

{
  "query": "Mars",
  "items": [],
  "degraded": true
}

Մշակեք նաև ցանցային խափանումը և JSON չհանդիսացող պատասխանը։ Պահեք վերջին հաջող տվյալները և կրկնեք ավելի ուշ․ մի գործարկեք անընդհատ կրկնություններ։

Օգտագործում և քեշ

  • Հաջող պատասխանները սահմանում են քեշավորումը․ հոսքը՝ 30 վայրկյան բրաուզերում և 60 վայրկյան ընդհանուր քեշում, որոնումը՝ 60 վայրկյան։ Հաշվի առեք քեշի վերնագրերը։
  • Կարդալու համար՝ GET, բրաուզերի նախնական հարցման համար՝ OPTIONS։ Բանալի պետք չէ, այլ դոմենից կարդալը թույլատրված է։ Մի գործարկեք անընդհատ հարցումներ և կրկնություններ։
  • Տեքստերը պատկանում են խմբագրություններին։ Աղբյուրների հղումները պետք է ընթերցողին տանեն սկզբնական հրապարակում։