OsonTopshir API
Loyiha holati: Hamkor API ishga tushirilmoqda. Quyidagi shartnoma (kontrakt) yakuniy v1 ko'rinishida, lekin kalitlar hozircha faqat tanlangan hamkorlarga beriladi.

Kurs ishi

Titul sahifasi, mundarija, boblar, xulosa va adabiyotlar ro'yxati bilan to'liq kurs ishi. Natija — DOCX fayl.

POST/v1/orders   service: "kurs_ishi"

Parametrlar (params)

topicstringmajburiy

Kurs ishi mavzusi, 5–300 belgi.

subjectstringmajburiy

Fan nomi, masalan «Menejment».

pagesstringixtiyoriy

Hajm diapazoni: 20-30 (standart), 30-40 yoki 40-50. Narx hammasi uchun bir xil: 1 kredit.

languagestringixtiyoriy

uz (standart), ru, en.

studentobjectixtiyoriy

Titul sahifasi uchun: full_name, university, faculty, direction, group, supervisor, city. Berilmagan maydonlar bo'sh qoladi.

Misol

curl https://api.osontopshir.uz/partner/v1/orders \
  -H "Authorization: Bearer $OSONTOPSHIR_API_KEY" \
  -H "Idempotency-Key: kurs-2001" \
  -H "Content-Type: application/json" \
  -d '{
    "service": "kurs_ishi",
    "params": {
      "topic": "Korxonada xodimlarni boshqarish tizimi",
      "subject": "Menejment",
      "pages": "30-40",
      "language": "uz",
      "student": {
        "full_name": "Aliyev Vali",
        "university": "Toshkent davlat iqtisodiyot universiteti",
        "faculty": "Iqtisodiyot",
        "group": "IQ-21",
        "supervisor": "Karimov S."
      }
    }
  }'
r = requests.post(
    "https://api.osontopshir.uz/partner/v1/orders",
    headers={**H, "Idempotency-Key": "kurs-2001"},
    json={
        "service": "kurs_ishi",
        "params": {
            "topic": "Korxonada xodimlarni boshqarish tizimi",
            "subject": "Menejment",
            "pages": "30-40",
            "language": "uz",
            "student": {
                "full_name": "Aliyev Vali",
                "university": "Toshkent davlat iqtisodiyot universiteti",
                "faculty": "Iqtisodiyot",
                "group": "IQ-21",
                "supervisor": "Karimov S.",
            },
        },
    },
)
const r = await fetch("https://api.osontopshir.uz/partner/v1/orders", {
  method: "POST",
  headers: { ...H, "Idempotency-Key": "kurs-2001", "Content-Type": "application/json" },
  body: JSON.stringify({
    service: "kurs_ishi",
    params: {
      topic: "Korxonada xodimlarni boshqarish tizimi",
      subject: "Menejment",
      pages: "30-40",
      language: "uz",
      student: {
        full_name: "Aliyev Vali",
        university: "Toshkent davlat iqtisodiyot universiteti",
        faculty: "Iqtisodiyot",
        group: "IQ-21",
        supervisor: "Karimov S.",
      },
    },
  }),
});

Natija

result.files da bitta DOCX fayl bo'ladi. Tayyorlash 5–15 daqiqa oladi, shuning uchun webhookdan foydalaning.

Cheklovlar

  • Hujjat umumiy mavzu bo'yicha tayyorlanadi. Aniq korxona ma'lumotlari (raqamlar, hisobotlar) berilmagani uchun amaliy qismdagi misollar ko'rgazmali (illyustrativ) bo'lishi mumkin.
  • Adabiyotlar ro'yxati ommaviy manbalarga tayanadi, topshirishdan oldin havolalarni tekshirish tavsiya etiladi.
  • Originallik darajasi (antiplagiat) kafolatlanmaydi.