Har kuni internetda saytlarni ochamiz, mobil ilovalarni ishlatamiz, botlar bilan gaplashamiz. Bularning barchasi API tufayli ishlaydi. API – bu ikki dastur o‘rtasidagi ko‘prik. Bu qo‘llanmada API nima ekanligini, REST API qanday ishlashini, real kod misollarini ko‘rasiz va oxirida Telegram API orqali o‘zingiz xabar yuborasiz.

API nima – oddiy tushuntirish

API (Application Programming Interface) – bu dasturiy ta’minotning boshqa dastur bilan muloqot qilish usuli. Oddiy misol: restoranda ofitsiant siz va oshxona o‘rtasida vositachi. Siz buyurtma berasiz, ofitsiant oshxonaga uzatadi va sizga taomni olib keladi. API ham xuddi shunday – siz so‘rov yuborasiz, server qayta ishlaydi va javob qaytaradi.

Asosiy qoida: API orqali siz server ichidagi ma’lumotlarga yoki funksiyalarga to‘g‘ridan-to‘g‘ri kirmaysiz, balki belgilangan yo‘llar orqali so‘rov yuborasiz.

REST API nima

REST (Representational State Transfer) – bu API yozish uchun arxitektura uslubi. REST API HTTP protokoli orqali ishlaydi va quyidagi asosiy metodlardan foydalanadi:

MetodVazifaMaqsad
GETMa’lumot olishFoydalanuvchi ro‘yxatini olish
POSTYangi ma’lumot yaratishYangi foydalanuvchi qo‘shish
PUTMa’lumotni to‘liq yangilashFoydalanuvchi ma’lumotlarini o‘zgartirish
DELETEMa’lumotni o‘chirishFoydalanuvchini o‘chirish

REST API JSON formatida ma’lumot qaytaradi. JSON – bu odam va mashina o‘qiy oladigan yengil format.

{
  "id": 1,
  "name": "Ali Valiyev",
  "email": "ali@example.com"
}

Real kod misollari

Endi amaliyotga o‘tamiz. JavaScript (fetch) va Python (requests) yordamida API so‘rovlarini ko‘ramiz.

JavaScript – fetch orqali GET so‘rov

const url = "https://jsonplaceholder.typicode.com/users";

fetch(url)
  .then(response => response.json())
  .then(data => {
    console.log(data);
  })
  .catch(error => {
    console.error("Xatolik:", error);
  });

Python – requests orqali POST so‘rov

import requests
import json

url = "https://jsonplaceholder.typicode.com/users"
data = {
  "name": "Shahzod",
  "email": "shahzod@example.com"
}

response = requests.post(url, json=data)
print(response.json())

Node.js – axios orqali GET so‘rov

const axios = require("axios");

axios.get("https://jsonplaceholder.typicode.com/posts/1")
  .then((response) => {
    console.log(response.data);
  })
  .catch((error) => {
    console.error(error);
  });

HTTP status kodlari

API so‘rovlaridan keyin server status kod qaytaradi. Eng muhimlari:

KodMa’nosi
200 OKSo‘rov muvaffaqiyatli
201 CreatedYangi resurs yaratildi
400 Bad RequestNoto‘g‘ri so‘rov
401 UnauthorizedAvtorizatsiya talab qilinadi
404 Not FoundResurs topilmadi
500 Internal Server ErrorServer xatosi

Telegram API orqali xabar yuborish

Telegram bot yaratish – API bilan ishlashning eng yaxshi amaliy misollaridan biri. Telegram bot token olish va xabar yuborish juda oddiy.

1-qadam: Bot yaratish

Telegram’da @BotFather ga yozing va /newbot buyrug‘ini bering. Sizga bot token beriladi. Token shunga o‘xshaydi:

1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ

2-qadam: Xabar yuborish (cURL)

Terminal orqali sinab ko‘ring:

curl -X POST "https://api.telegram.org/bot/sendMessage" \
  -d "chat_id=123456789" \
  -d "text=Salom, bu API orqali yuborilgan xabar"

3-qadam: Python orqali Telegram API

import requests

TOKEN = "1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ"
CHAT_ID = "123456789"
url = f"https://api.telegram.org/bot{TOKEN}/sendMessage"
params = {
  "chat_id": CHAT_ID,
  "text": "Salom! Bu Python orqali yuborildi."
}

response = requests.get(url, params=params)
print(response.json())

4-qadam: JavaScript (Node.js) orqali Telegram API

const axios = require("axios");

const TOKEN = "1234567890:ABCdefGHIjklMNOpqrSTUvwxYZ";
const CHAT_ID = "123456789";

axios.post(`https://api.telegram.org/bot${TOKEN}/sendMessage`, {
  chat_id: CHAT_ID,
  text: "Salom! Bu Node.js orqali yuborildi."
})
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

API dan foydalanish bo‘yicha amaliy maslahatlar

  • API hujjatlarini o‘qing: Har bir API o‘ziga xos, hujjatsiz ish boshlamang.
  • Limitlarni bilish: Ko‘p API da so‘rovlar soni cheklangan (rate limiting).
  • Xatoliklarni ushlang: Har doim try/catch yoki .catch() ishlating.
  • Token va kalitlarni yashiring: .env faylida saqlang, Git ga qo‘ymang.
  • Postman dan foydalaning: API sinab ko‘rish uchun eng yaxshi vosita.

Professional maslahat: API ga so‘rov yuborishdan oldin, Postman yoki Insomnia yordamida sinab ko‘ring. Shundan keyin kod yozing.

Xulosa

API – zamonaviy dasturlashning asosi. REST API orqali siz har qanday xizmat bilan muloqot qila olasiz. Bugun siz API nima ekanini, qanday ishlashini, HTTP metodlarni, JSON formatini, real kod misollarini va Telegram API orqali xabar yuborishni o‘rgandingiz.

Endi o‘zingiz sinab ko‘ring. Telegram bot yarating va birinchi xabarni yuboring. API ni o‘rganishning eng yaxshi usuli – amaliyot.

Foydali manbalar: