Genel bakış

Pay Partner'ın mobil uygulaması tek bir uç ile konuşur:

POST https://app.paypartner.ae/api.php
Content-Type: application/x-www-form-urlencoded

REST değil. Yol her zaman aynıdır; hangi işin yapılacağını gövdedeki islem alanı belirler.

curl -X POST https://app.paypartner.ae/api.php \
  -d "islem=faturalar" \
  -d "api=<jeton>" \
  -d "durum=1"

Yanıt zarfı

Bütün yanıtlar aynı zarfla döner, HTTP durum kodu her zaman 200'dür, başarı HTTP kodundan değil durum alanından anlaşılır.

{
  "durum": "true",
  "cevap": { }
}

Alan	Tip	Anlamı
durum	metin	"true" ya da "false". Boole değil, metin.
cevap	nesne, dizi ya da metin	Başarıda veri, hatada mesaj
kod	sayı	Yalnız bazı hatalarda (401 gibi)

İstemci tarafında dikkat

durum alanı true değil "true" döner. Swift ve Kotlin tarafında doğrudan Bool'a çözmeye çalışmak sessizce başarısız olur; metin olarak okuyup karşılaştırın.

İşlem sayısı

Uçta 74 işlem tanımlı. 45'i veri değiştiriyor, 29'u yalnız okuyor. Tamamı bu bölümün "İşlemler" başlığı altında listelendi.

Sözleşme elle yazılmadı; zorunlu alanlar ve yetki koşulları api.php kaynağından çıkarıldı (~/paypartner/araclar/api_sozlesme_cikar.py). Yani bu tablolar kodun kendisiyle tutarlıdır, tahmin değildir.

Kimlik

giris dışındaki her işlem api alanında bir jeton ister. Jeton modelinin mobil için önemli bir kısıtı var; Kimlik sayfasını mutlaka okuyun.

28.08.2026'da değişenler

Mobil uygulama hazırlığı kapsamında kimlik modeli yenilendi:

• Çoklu cihaz açıldı. Eskiden kullanıcı başına tek jeton saklanıyordu, her giriş bir öncekini eziyordu. Artık her giriş kendi oturumunu açar.
• Çıkış ve cihaz yönetimi geldi. cikis, oturumlar, oturumkapat işlemleri.
• Oturum süresi: 90 gün hareketsizlik.
• Silinen ya da pasife alınan kullanıcının jetonu artık geçersiz. Önceden çalışmaya devam ediyordu.
• CORS beyaz listeye alındı. Önceden her kaynağı yansıtıyordu.

Ayrıntı: Kimlik ve oturum.

Hâlâ eksik

• Push bildirimi yok. firebaseapi işlemi cihaz jetonunu kaydediyor ama sunucuda bildirim gönderen kod yok. Kayıtlı cihaz sayısı bugün sıfır. Uygulama sessiz.