Başlangıç

Hızlı Başlangıç

İlk API çağrını üç adımda yapacaksın: giriş yap, dönen token'ı al, o token ile korumalı bir endpoint çağır. Backend bilgisine ihtiyacın yok.

Ön koşullar

  • Bir test kullanıcısı (kısa kullanıcı adı veya e-posta) ve şifresi.
  • API adresi (base URL). Şu an bu rehberin hedeflediği adres: https://<api-adresi>.
  • İstek atmak için: bu rehberdeki İnteraktif Referans, veya Unity'de UnityWebRequest / herhangi bir HTTP istemcisi.
Base URL nedir? Tüm endpoint yolları /api/... ile başlar ve base URL'nin sonuna eklenir. Örnek: https://<api-adresi>/api/health.

3 adımda ilk çağrı

1

Giriş yap ve token al

POST /api/auth/login — anonim (token gerekmez).

İstek gövdesi 
{
  "loginIdentifier": "test_kullanici",
  "password": "sifre123"
}
Cevap (200) 
{
  "isSuccess": true,
  "statusCode": "OK",
  "message": "OK",
  "data": {
    "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6...",
    "expiresOnUtc": "2026-07-25T18:30:00Z",
    "user": {
      "id": 42,
      "username": "test_kullanici",
      "nameSurname": "Test Öğrenci",
      "grade": 5,
      "currentWpm": 120
    }
  }
}

data.accessToken'i sakla — sonraki adımda kullanacaksın.

2

Token'ı Authorization başlığına koy

Korumalı her istekte şu başlığı gönder:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6...

Detaylı akış: Kimlik Doğrulama.

3

Korumalı bir endpoint çağır

GET /api/me/profile — giriş yapan kullanıcının profili.

cURL 
curl "https://<api-adresi>/api/me/profile" \
  -H "Authorization: Bearer <accessToken>"

Başarılıysa isSuccess: true ve data içinde profil gelir.

Tarayıcıdan çalıştırma (Execute)

Kod yazmadan denemek için İnteraktif Referans'ı aç:

  1. Auth → Login endpoint'ini seç, örnek gövdeyi doldur, Execute.
  2. Cevaptaki accessToken'ı kopyala.
  3. Sağ üstteki kilit/Authentication alanına bearer token olarak yapıştır.
  4. Artık korumalı endpointleri de Execute ile deneyebilirsin.
Execute isteği nereye gider? Referanstaki "Execute" istekleri https://<api-adresi> adresine gider. Bu değer appsettings.json › Api:BaseUrl'den okunur; API yayınlanınca oraya gerçek adres yazılır.