Laravel 12 IP Zekası ile Modern IPStack Servis Katmanı (sudiptpa/ipstack + sudiptpa/guid)

Laravel 12 kullanarak IpstackService isimli bir servis geliştirdim. Bu, sudiptpa/ipstack kütüphanesi ile entegre olan, tiplenmiş IP istihbarat iş akışları için modern bir PHP kütüphanesidir.

Detaylı bir öğretici makale burada:

👉 https://sujipthapa.com/blog/ipstack-laravel-integration

Neden bu implementasyon önemlidir

Bu sadece bir paket demosu değildi. Aşağıdaki tüm özellikler ile entegre bir yapı geliştirdim:

• Web + API doğrulama uç noktaları
• IpstackService etrafında servis katmanı mimarisi
• sudiptpa/guid ile istek izlenebilirliği
• Denetim/gözlem için doğrulama kalıcılığı
• Gerçek dünya güvenilirliği için ücretsiz plan uyumlu davranış

Kullanılan Yığın

• sudiptpa/ipstack

  IPStack sorguları için modern, PSR uyumlu PHP kütüphanesi (single, requester, optimized, bulk).

• sudiptpa/guid

  İstek seviyesinde izleme ID’leri için hafif GUID üretimi.

Laravel 12’de neler geliştirdim

1. Servis öncelikli tasarım

Özel bir IpstackService tüm sorgulama iş akışlarını yönetir:

• Tekil sorgulama
• Requester sorgulaması (/check)
• Seçenekler kullanarak optimize edilmiş sorgulama (fields, language, plan uyumlu davranış)
• Grasif geri dönüş ile toplu sorgulama

2. Gerçek dünya ücretsiz plan yönetimi

Üretim tarzında iki pratik sorun çözülmüştür:

• Ücretsiz plan üzerinde optimize edilmiş sorgulama 400

  Gelişmiş seçenekler açıkça etkinleştirilmediği sürece, ücretsiz güvenli varsayılanlar kullanılarak düzeltildi.

• Ücretsiz plan üzerinde toplu sorgulama 403

  Art arda tekil IP sorgulamaları ile geri dönüşe geçiş ile düzeltildi.

3. İzlenebilir doğrulama kayıtları

Her isteğe bir GUID (verification_guid) atanarak, sonuç/hata bağlamı kalıcı hale getirilir. Bu, daha kolay hata ayıklama ve destek sağlar.

Implement edilen uç noktalar

Web

• GET /ip-verifications
• POST /ip-verifications
• POST /ip-verifications/requester
• POST /ip-verifications/optimized
• POST /ip-verifications/bulk

API

• POST /api/ip-verifications
• POST /api/ip-verifications/requester
• POST /api/ip-verifications/optimized
• POST /api/ip-verifications/bulk

Sonuç

Sonuç, modern bir PHP IPStack istemcisi kullanarak oluşturulmuş sağlam bir Laravel 12 IP istihbaratı özelliğidir ve gerçek plan kısıtlamaları için pratik güvenilirlik iyileştirmeleri sunmaktadır.

Tam teknik öğretici makaleyi, kod yapısını ve uygulama yürütme sürecini okumak için:

👉 https://sujipthapa.com/blog/ipstack-laravel-integration