API ۋە Widget
ئۇيغۇرچە سۈنئىي ئىدراك ئىزدەشنى ئۆز تور بېكىتىڭىزگە ياكى ئەپىڭىزگە قوشۇڭ — ھەقسىز، بىر قۇر كود بىلەن.
1. تور بېكەت Widget
تۆۋەندىكى كودنى HTML غا چاپلاڭ. data-mode="redirect" بولسا ئىزدەش ئىدراكتا ئېچىلىدۇ؛ inline بولسا جاۋاب بېتىڭىزنىڭ ئۆزىدە كۆرۈنىدۇ.
<div id="idirak-search"></div>
<script src="https://izde.idirak.com/widget.js"
data-target="#idirak-search"
data-mode="inline"
data-theme="light"
data-script="arabic"
async></script>جانلىق كۆرۈنۈش:
2. JSON API
GET ياكى POST /api/v1/search — CORS ئوچۇق. ئاچقۇچسىز ھەر IP دىن سائىتىگە 20 تەلەپ؛ تېخىمۇ كۆپ لازىم بولسا ئاچقۇچ ئىلتىماس قىلىڭ.
cURL
curl "https://izde.idirak.com/api/v1/search?q=%D8%A6%DB%87%D9%8A%D8%BA%DB%87%D8%B1%20%D8%AA%D9%89%D9%84%D9%89%D9%86%D9%89%DA%AD%20%D8%AA%D8%A7%D8%B1%D9%89%D8%AE%D9%89"JavaScript
const res = await fetch("https://izde.idirak.com/api/v1/search", {
method: "POST",
headers: {
"Content-Type": "application/json",
// Optional: higher rate limits with an issued key
// "X-API-Key": "YOUR_KEY",
},
body: JSON.stringify({
q: "uyghur tarixi", // Arabic, Latin (ULY) or Cyrillic
script: "latin", // answer script: arabic | latin | cyrillic
style: "default", // default | kids | voice
}),
});
const { answer, sources } = await res.json();Response
{
"query": "uyghur tarixi",
"answer": "Uyghur tarixi ...",
"research_answer": "Uyghur tarixi ... [[citation:s-example]]",
"answer_script": "latin",
"sources": [
{ "id": "s-example", "name": "…", "url": "https://…", "status": "page", "evidence": "Supporting passage…" }
],
"projects": [
{ "name": "…", "url": "https://….idirak.com/", "description": "…" }
],
"cached": false
}پارامېتىرلار
| q | string, required | سوئال (1–1000 ھەرپ). ئەرەب، لاتىن ياكى كىرىل يېزىقىدا بولسا بولىدۇ. |
| script | arabic | latin | cyrillic | جاۋابنىڭ يېزىقى. سۈكۈتتىكىسى arabic. |
| style | default | kids | voice | جاۋاب ئۇسلۇبى: نورمال، بالىلار ئۈچۈن ياكى ئاۋاز ئۈچۈن قىسقا. |
| deep | boolean | چوڭقۇر تەتقىقات (ئاستا، تېخىمۇ تەپسىلىي). |
| history | array (POST only) | ئالدىنقى سۆھبەت: [{role, content}], ئەڭ كۆپ 12. |
چەكلىمىدىن ئاشسا 429 قايتىدۇ؛ X-RateLimit-* باشلىقلىرى قالغان سانىنى كۆرسىتىدۇ. جاۋابلار سۈنئىي ئىدراك تەرىپىدىن ھاسىل قىلىنىدۇ — مەنبەلەرنى كۆرسىتىڭ.