ویرگول
ورودثبت نام
Nastooh
Nastooh
Nastooh
Nastooh
خواندن ۲ دقیقه·۵ ماه پیش

Postman - Endpoint Structure (HTTP/HTTPS, URL vs URI)

جمع‌بندی آزمونی سرفصل

Endpoint چیست؟

Endpoint نقطه دسترسی یک API است که Client از طریق آن با Server ارتباط برقرار می‌کند.
Endpoint معمولاً شامل Protocol + Domain + Path + Parameters است و نشان می‌دهد درخواست دقیقاً به کدام Resource ارسال می‌شود.

مثال:

https://api.bank.com/v1/customers/12345

HTTP vs HTTPS

HTTP (HyperText Transfer Protocol)

یک پروتکل برای انتقال داده بین Client و Server است.

ویژگی‌ها:

  • داده‌ها بدون Encryption منتقل می‌شوند

  • امنیت پایین

  • مناسب محیط‌های غیرحساس (تست / داخلی)

مثال:

http://example.com/api/customers

HTTPS (HTTP Secure)

نسخه امن HTTP است که از SSL/TLS Encryption استفاده می‌کند.

ویژگی‌ها:

  • داده‌ها Encrypted هستند

  • جلوگیری از Man-in-the-Middle Attack

  • مناسب سیستم‌های حساس (بانکی، مالی، لاگین)

مثال:

https://api.bank.com/customers
تفاوت مهم آزمونی HTTP vs HTTPS
تفاوت مهم آزمونی HTTP vs HTTPS

URL vs URI

URI (Uniform Resource Identifier)

یک شناسه کلی برای Resource است.
URI می‌تواند:

  • Location (URL)

  • یا Name (URN)
    باشد.

URL (Uniform Resource Locator)

نوعی از URI است که محل دقیق Resource را مشخص می‌کند.

رابطه مهم آزمونی:

👉 URL ⊂ URI

یعنی:

  • هر URL یک URI است

  • اما هر URI الزاماً URL نیست

مثال ساده:

URI:

customers/12345

URL:

https://api.bank.com/customers/12345
تفاوت URL و URI
تفاوت URL و URI

Endpoint Structure (ساختار Endpoint)

یک Endpoint کامل معمولاً شامل این بخش‌هاست:

https://api.example.com:443/v1/customers/123?active=true

اجزا:

1. Protocol

https

نوع ارتباط (HTTP یا HTTPS)

2. Domain

api.example.com

آدرس سرور

3. Port (اختیاری)

443

پورت ارتباط

4. Path

/ v1 / customers / 123

مسیر Resource

5. Query Parameter

?active=true

فیلتر یا کنترل رفتار درخواست

نکات مهم آزمونی (L7 → L8)

1. Endpoint = Resource Locator

Endpoint باید:

  • یک Resource را مشخص کند

  • قابل فهم باشد

  • RESTful باشد

2. REST Design Rule

  • استفاده از noun نه verb:
    ❌ /getCustomer
    ✅ /customers/123

3. HTTPS اهمیت امنیتی

در APIهای مالی:

  • استفاده از HTTP = ریسک شدید

  • HTTPS = استاندارد الزامی

4. URI vs URL در تست

Backend Tester باید بداند:

  • Swagger معمولاً URL را نمایش می‌دهد

  • Contract ممکن است URI-level design داشته باشد

  • تست باید URL واقعی را validate کند

5. Common Failureها

  • استفاده از HTTP به جای HTTPS

  • Endpoint اشتباه (404)

  • Path mismatch

  • Query injection

  • Incorrect routing

  • Broken versioning in path (/v1/ vs /v2/)

نکته کلیدی آزمونی

در پاسخ کامل باید این کلیدواژه‌ها دیده شوند:

Endpoint, HTTP, HTTPS, SSL/TLS, URL, URI, Resource, Path, Query Parameter, Domain, Protocol, Port, RESTful Design

نمونه پاسخ کامل کوتاه

Endpoint آدرس دسترسی به یک Resource در API است که شامل Protocol (HTTP/HTTPS)، Domain، Path و Parameters می‌باشد. HTTP پروتکل بدون امنیت است، در حالی که HTTPS با استفاده از SSL/TLS داده‌ها را رمزنگاری می‌کند. URL نوعی از URI است که محل دقیق Resource را مشخص می‌کند، در حالی که URI یک شناسه کلی برای Resource است. در طراحی API باید از ساختار RESTful و استفاده از HTTPS برای امنیت و از URLهای استاندارد برای دسترسی به منابع استفاده شود.

کلیدواژه‌ها

Endpoint HTTP HTTPS SSL/TLS URL URI Resource Path Query Parameter Domain Port RESTful API API Structure Secure Communication

۰
۰
Nastooh
Nastooh
شاید از این پست‌ها خوشتان بیاید