API құжаттамасы
ortcom.kz деректеріне қол жеткізу үшін ашық API. Жаңалықтар, АнтиФейк, іс-шаралар және аймақтар.
https://ortcom.qdev.run/api/v1/
Шолу
ortcom.kz Public API жаңалықтарға, АнтиФейк деректеріне, баспасөз іс-шараларына және аймақтық ақпаратқа бағдарламалық қол жеткізуді қамтамасыз етеді. API RESTful принциптеріне негізделген және JSON форматында жауап береді.
Аутентификация
Қазіргі уақытта API аутентификациясыз жұмыс істейді. Барлық ашық деректер еркін қол жетімді. Болашақта API кілттері арқылы кеңейтілген қол жеткізу қосылады.
Беттеу
Тізім endpoints-тері беттеуді қолдайды:
/api/v1/articles?page=2&limit=10
{
"api_version": "1.0.0",
"meta": {
"total": 1250,
"page": 2,
"per_page": 10,
"pages": 125
},
"data": [...]
}| Параметр | Түрі | Сипаттама |
|---|---|---|
page | int | Бет нөмірі (1-ден бастап) |
limit | int | Бет бойынша элементтер (макс. 100) |
Қателер
| Код | Сипаттама |
|---|---|
200 | Сәтті |
404 | Ресурс табылмады |
422 | Қате параметрлер |
429 | Лимит асып кетті |
AI / LLM контурлары
Бұл endpoints AI жүйелеріне HTML-парсингсіз, арзан және тұрақты machine-readable access береді. Canonical URL, citation және provenance өрістері бірге қайтарылады.
/api/v1/ai/latest
Статьялар, ЦБД және press events үшін JSONL discovery-feed.
| Параметр | Түрі | Сипаттама |
|---|---|---|
lang | string | ru, kk, en |
limit | int | 1..50 |
max_chars | int | 300..4000 |
include | string | articles, antifake, events |
curl 'https://ortcom.qdev.run/api/v1/ai/latest?lang=ru&include=articles,antifake&limit=3'/api/v1/ai/article/{source_id_or_slug}
Бір мақала үшін compact JSON detail.
/api/v1/ai/article/{source_id_or_slug}/markdown
Мақаланың markdown-нұсқасы ingestion үшін.
/api/v1/ai/antifake/{id_or_slug}
Бір фактчекинг жазбасы үшін compact JSON detail.
/api/v1/ai/event/{id_or_slug}
Баспасөз іс-шарасы үшін compact JSON detail.
Мақалалар
/api/v1/articles
Мақалалар тізімі, фильтрлермен.
| Параметр | Түрі | Сипаттама |
|---|---|---|
lang | string | ru, kk, en |
category | string | Санат slug (novosti, region-news...) |
q | string | Іздеу |
date_from | string | YYYY-MM-DD |
date_to | string | YYYY-MM-DD |
curl https://ortcom.qdev.run/api/v1/articles?lang=ru&category=novosti&limit=5/api/v1/articles/{id}
Жеке мақала, толық мәтінмен.
Санаттар
/api/v1/categories
Барлық белсенді санаттар тізімі.
АнтиФейк (ЦБД)
/api/v1/antifake
АнтиФейк жазбалары тізімі.
| Параметр | Түрі | Сипаттама |
|---|---|---|
verdict | string | fake, misleading, manipulated, unverified |
post_type | string | debunk, digest, advisory, analysis |
q | string | Іздеу |
curl https://ortcom.qdev.run/api/v1/antifake?verdict=fake&limit=10/api/v1/antifake/stats
Жалпы статистика: вердикт бойынша, айлық трендтер.
/api/v1/antifake/{id}
Жеке жазба, толық мәтінмен.
Іс-шаралар
/api/v1/events
Баспасөз іс-шаралары тізімі.
| Параметр | Түрі | Сипаттама |
|---|---|---|
status | string | announced, live, completed, cancelled |
event_type | string | briefing, conference, soyle, roundtable |
Аймақтар
/api/v1/regions
Қазақстан аймақтарының тізімі.
/api/v1/regions/{slug}/articles
Нақты аймаққа қатысты мақалалар.
Тестілеу
Нәтиже мұнда көрсетіледі