Poyra’nın etkileşimli API referansını her kurulum kendisi sunar: tarayıcıda https://api.ornek.com/docs (Scalar arayüzü), ham şema /swagger/v1/swagger.json. Oradaki içerik her zaman çalışan sürümünüzle eşleşir; bu sayfa ise haritayı verir. Genel sözleşmeler her uçta aynıdır: kimlik üç yoldan gelir, hata gövdesi tek biçimdir, tutarlar kuruş, enum’lar snake_case, liste yanıtları çıplak JSON dizisidir. Liste uçları limit (tavan 200) kabul eder; yalnız GET /v1/payments imleçli sayfalama kullanır (before + status).

Uç noktaların haritası

Kimlik özetleri

  • X-Api-Key — sunucudan sunucuya; rol denetiminden muaf, tam yetkili.
  • Authorization: Bearer — panel kullanıcıları; yazma uçları rol eşiğine tabidir.
  • X-Platform-Key — yalnız üç platform işlemi: kiracı açma, BIN kataloğu, banka tatili yükleme.
  • Kimliksiz — banka geri dönüşü (tek kullanımlık jetonla), giriş/parola uçları ve sağlık uçları.
Para hareketi başlatan POST’larda (ödemeler, iadeler, abonelikler) Idempotency-Key gönderin.