---
title: "REST API اینڈ پوائنٹس | Tajo"
description: "REST API اینڈ پوائنٹس کی دستاویزات"
url: https://tajo.io/ur/docs/endpoints/rest-api/
markdown: https://tajo.io/ur/docs/endpoints/rest-api.md
lang: ur-PK
author: "Set Noa"
author_url: https://tajo.io/ur/set-noa/
robots: noindex
---

ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

# REST API اینڈ پوائنٹس

[Set Noa](https://tajo.io/ur/set-noa/)

Caution

**ڈیمو صفحہ** - یہ ایک ڈیمو صفحہ ہے جو ملٹی ٹیب دستاویزات کی خصوصیت دکھاتا ہے۔ یہ مواد صرف وضاحت کے لیے ہے۔

ہمارا REST API ڈیٹا تک رسائی اور اس میں تبدیلی کے لیے اینڈ پوائنٹس فراہم کرتا ہے۔ تمام اینڈ پوائنٹس ڈیٹا JSON فارمیٹ میں واپس کرتے ہیں۔

## بنیادی URL

تمام API درخواستیں اس بنیادی URL پر بھیجی جانی چاہئیں:

```
https://api.example.com/v1
```

## یوزرز کے اینڈ پوائنٹس

### تمام یوزرز حاصل کریں

```http
GET /users
```

تمام یوزرز کی فہرست واپس کرتا ہے۔ pagination کے پیرامیٹرز کی سپورٹ موجود ہے۔

**کوئری پیرامیٹرز:**

| پیرامیٹر | قسم | تفصیل |
| --- | --- | --- |
| page | integer | صفحہ نمبر (ڈیفالٹ: 1) |
| limit | integer | فی صفحہ ریکارڈز کی تعداد (ڈیفالٹ: 50، زیادہ سے زیادہ: 100) |
| sort | string | ترتیب دینے کے لیے فیلڈ (مثلاً “name”، “created\_at”) |

**جواب:**

```json
{
  "data": [
    {
      "id": "user_123",
      "name": "John Doe",
      "email": "john@example.com",
      "created_at": "2023-01-15T08:30:00Z"
    },
    // More users...
  ],
  "meta": {
    "total": 250,
    "page": 1,
    "limit": 50
  }
}
```

### ID سے یوزر حاصل کریں

```http
GET /users/{id}
```

ID کے ذریعے ایک یوزر واپس کرتا ہے۔

**جواب:**

```json
{
  "data": {
    "id": "user_123",
    "name": "John Doe",
    "email": "john@example.com",
    "created_at": "2023-01-15T08:30:00Z",
    "profile": {
      "bio": "Software developer",
      "location": "New York",
      "avatar_url": "https://example.com/avatars/john.jpg"
    }
  }
}
```

## پروڈکٹس کے اینڈ پوائنٹس

### تمام پروڈکٹس حاصل کریں

```http
GET /products
```

تمام پروڈکٹس کی فہرست واپس کرتا ہے۔ فلٹرنگ اور pagination کی سپورٹ موجود ہے۔

**کوئری پیرامیٹرز:**

| پیرامیٹر | قسم | تفصیل |
| --- | --- | --- |
| category | string | کیٹیگری کے مطابق فلٹر کریں |
| min\_price | number | کم سے کم قیمت کے مطابق فلٹر کریں |
| max\_price | number | زیادہ سے زیادہ قیمت کے مطابق فلٹر کریں |
| page | integer | صفحہ نمبر (ڈیفالٹ: 1) |
| limit | integer | فی صفحہ ریکارڈز کی تعداد (ڈیفالٹ: 50، زیادہ سے زیادہ: 100) |

**جواب:**

```json
{
  "data": [
    {
      "id": "prod_123",
      "name": "Example Product",
      "description": "This is an example product",
      "price": 49.99,
      "category": "electronics"
    },
    // More products...
  ],
  "meta": {
    "total": 350,
    "page": 1,
    "limit": 50
  }
}
```

## خامیوں کو سنبھالنا

تمام اینڈ پوائنٹس معیاری HTTP اسٹیٹس کوڈز کی پیروی کرتے ہیں اور ضرورت کے مطابق تفصیلی خامی کے پیغامات شامل کرتے ہیں:

| اسٹیٹس کوڈ | تفصیل |
| --- | --- |
| 200 | OK - درخواست کامیاب رہی |
| 400 | Bad Request - غلط پیرامیٹرز |
| 401 | Unauthorized - تصدیق درکار ہے |
| 403 | Forbidden - اجازتیں ناکافی ہیں |
| 404 | Not Found - وسیلہ موجود نہیں |
| 429 | Too Many Requests - ریٹ لمٹ سے تجاوز |
| 500 | Internal Server Error - سرور کی خامی پیش آئی |

خامی کے جوابات میں ایک پیغام شامل ہوتا ہے جو بتاتا ہے کہ کیا غلط ہوا:

```json
{
  "error": {
    "code": "invalid_parameter",
    "message": "The parameter 'email' is not a valid email address",
    "request_id": "req_abc123"
  }
}
```