@extends('admin.layout.layout') @section('title', 'Personel API Dokümanı') @section('content')

Personel API Dokümanı

API istemcisi oluşturma, token teslimi ve destek takibi için iç kullanım rehberi.

Karşı Taraf Dokümanı API Yönetimi Yeni API İstemcisi
Bu sayfa Markest personeli içindir. Banka veya kuruma gönderilecek doküman ayrıdır: Karşı Taraf Dokümanı.

1. API Açmadan Önce Kurumdan Alınacak Bilgiler

Kurum adı Banka, kurum veya entegrasyon firmasının resmi adı.
Yetkili kişi Teknik tarafta tokenı teslim alacak kişi.
Yetkili e-posta Destek ve bilgilendirme için kullanılacak adres.
Sabit IP adresleri Kurum API isteği hangi IP adreslerinden atacaksa liste alın. Bilmiyorlarsa boş bırakılabilir.
Banka kapsamı Sadece bir bankanın ilanlarını mı, yoksa tüm ilanları mı görecek?
Kullanım sıklığı Varsayılan 60 istek/dakika uygundur. Daha yoğun kullanım varsa not alın.

2. API İstemcisi Oluşturma

  1. Admin panelde API Yönetimi sayfasına girin.
  2. Yeni API İstemcisi butonuna basın.
  3. İstemci / Kurum Adı alanını doldurun.
  4. Yetkili Kişi ve Yetkili E-posta alanlarını doldurun.
  5. Kurum sadece belirli bir bankanın ilanlarını görecekse Banka Kapsamı seçin.
  6. IP bilgisi varsa İzinli IP Adresleri alanına yazın. Her satıra bir IP yazabilirsiniz.
  7. Dakika Limiti için ilk kurulumda 60 kullanın.
  8. Geçici erişim verilecekse Son Kullanım tarihi girin.
  9. Aktif işaretli kalsın ve Kaydet butonuna basın.
Token sadece oluşturma veya token yenileme sonrası bir kez gösterilir. Kaybolursa eski token görülemez; yeni token üretilmelidir.

3. Karşı Tarafa Verilecek Paket

Kurumun teknik ekibine şunlar verilir:

Token mk_live_... ile başlayan tek kullanımlık gösterilen token.
Karşı taraf teknik dokümanı Kurum API Teknik Kullanım Dokümanı
Varsa IP kapsamı Kurum hangi IP adreslerinden istek atabileceğini bilmelidir.
Varsa banka kapsamı Token yalnızca belirli bir bankaya kısıtlandıysa kurum bilgilendirilmelidir.

4. Token Teslim Kuralları

5. Destek Talebi Geldiğinde Kontrol Edilecekler

Durum Personelin Yapacağı Kontrol
Token çalışmıyor API istemcisi aktif mi, token yenilenmiş mi, son kullanım tarihi geçmiş mi kontrol edin.
IP hatası alıyorlar Kurumdan çıkış IP adresini isteyin ve istemci kaydına ekleyin.
Çok istek hatası alıyorlar Dakika limitini ve kurumun sorgu sıklığını kontrol edin.
Eksik ilan görüyorlar Banka kapsamı, status filtresi ve ilanın aktif/pasif/tamamlanmış durumu kontrol edilmeli.
Teknik hata bildiriyorlar Karşı taraftan X-Request-Id, istek URL'i, zaman ve hata kodu istenmelidir.

6. Log Takibi

API Yönetimi ekranındaki son istekler ve istemci detay ekranındaki loglar kontrol edilmelidir. Loglarda endpoint, HTTP status, hata kodu, IP ve request id bilgisi görülür.

@endsection