Authorize Servisi API Dökümantasyonu (v3)

Kullanıcı girişi, kayıt ve şifre işlemleri bu servis üzerinden yürütülür.

Base URL: /v3/authorize

---

Enum Referansları

User Type (user_type)

Değer	Açıklama
super-admin	Süper Yönetici
admin	Yönetici
subadmin	Alt Yönetici
driver	Sürücü
shipper	Gönderi Sahibi
branch	Şube
customer	Müşteri
franchise	Franchise
partner	Partner
fleet	Filo
operation	Operasyon
accounting	Muhasebe
transfer-center	Transfer Merkezi
region-officer	Bölge Sorumlusu
branch-user	Şube Kullanıcısı
centers-officer	Merkezler Sorumlusu

User Status (user_status)

passive, active, pending, removed

Work Status (work_status)

active, passive

Role (role_type)

individual, corporate

Source Type (source_type)

insource, outsource, rented, contracted, individual

Company Type (company_type)

person, limited, anonymous

---

1. Send OTP (Giriş Kodunu Gönder)

Kullanıcının telefon numarasına 6 haneli giriş kodu gönderir.

• URL: POST /send-otp
• Request Body:

  {
    "country_code": "+90",
    "phone": "5554443322"
  }

• Response:

  {
    "success": true,
    "data": {
      "full_phone": "+905554443322",
      "code_time": "2026-02-01T01:19:22.000Z"
    },
    "error": null
  }

2. Verify OTP (Giriş Kodunu Doğrula / Login)

Gönderilen kodu doğrular ve kullanıcıya Access/Refresh token çiftini döner.

• URL: POST /verify-otp
• Request Body:

  {
    "country_code": "+90",
    "phone": "5554443322",
    "verify_code": "123456"
  }

• Response:

  {
    "success": true,
    "data": {
      "user_id": "uuid-string",
      "access_token": "jwt-access-token",
      "refresh_token": "jwt-refresh-token"
    },
    "error": null
  }

3. Register (Kayıt Ol)

Sisteme yeni kullanıcı kaydeder.

• URL: POST /register
• Request Body:

  {
    "firstname": "Berke",
    "lastname": "Türk",
    "email": "test@example.com",
    "password": "...",
    "country_code": "+90",
    "phone": "5554443322",
    "user_type": "driver",
    "role_type": "individual",
    "company": {
      "title_brand": "Brand Name",
      "tax_no": "1234567890"
    }
  }

• Response:

  {
    "success": true,
    "data": null,
    "error": null
  }

4. Password Login

E-posta ve şifre ile giriş yaparak token alır.

• URL: POST /password
• Request Body:

  {
    "email": "test@example.com",
    "password": "your-password"
  }

• Response: (Verify OTP ile aynı yapıda token döner)

5. Update Password

Giriş yapmış kullanıcının şifresini değiştirir.

• URL: PUT /password
• Auth: Required
• Request Body:

  {
    "old_password": "...",
    "new_password": "..."
  }

• Response: data: null

6. Refresh Token

Refresh token kullanarak yeni bir Access token alır.

• URL: POST /refresh-token
• Auth: Required
• Request Body:

  {
    "refresh_token": "your-refresh-token"
  }

• Response:

  {
    "success": true,
    "data": {
      "authorize_id": "...",
      "user_id": "...",
      "access_token": "...",
      "refresh_token": "..."
    },
    "error": null
  }

7. Logout

Mevcut oturumu sonlandırır.

• URL: GET /logout
• Auth: Required
• Response:

  {
    "success": true,
    "data": {
      "authorize_id": "...",
      "access_token": null,
      "refresh_token": null
    },
    "error": null
  }

8. Verify Access (Erişim Kontrolü)

Token'ın geçerliliğini ve kullanıcı/client bilgilerini döner.

• URL: GET /verify-access
• Auth: Required
• Response:

  {
    "success": true,
    "data": {
      "client": { /* Client Interface */ },
      /* User Interface alanları doğrudan spread edilir */
      "user_id": "...",
      "user_type": "...",
      "authorize": { "authorize_id": "..." }
    },
    "error": null
  }