Watch-IP

Watch-IP'yi PHP ile Kullanma

digitload/watch-ip-sdk (Packagist, v0.1.1), GET /v1/geo'yu cURL üzerine kurulmuş bir Composer paketinde sarmalar — Guzzle veya başka bir HTTP istemci bağımlılığı yoktur.

Kurulum

PHP 8.1+ ve neredeyse her PHP kurulumuyla birlikte gelen curl ve json uzantılarını gerektirir.

Composer

composer require digitload/watch-ip-sdk

Hızlı başlangıç

Diğer sunucu tarafı SDK'larda olduğu gibi, GET /v1/geo'yu PHP'den çağırmak, onu bir ziyaretçinin tarayıcısından değil kendi sunucunuzdan çağırmak anlamına gelir; bu yüzden anahtarın izin verilen origin kontrolünü karşılamak için açık bir origin geçirin.

PHP

use Digitload\WatchIP\WatchIP;

$client = new WatchIP('wip_pub_xxxxxxxx', origin: 'https://example.com');
$geo = $client->getGeo();

echo $geo['country'], ' ', $geo['city'], ' ', $geo['timezone'];

Hata işleme ve zaman aşımları

Her başarısızlık, \RuntimeException'ı genişleten bir WatchIPError fırlatır. PHP'nin Exception::getCode()'u int tipindedir, ama API'nin hata kodları string'tir; bu yüzden bunları getCode() yerine getErrorCode() ile okuyun. options dizisinde include'un yanına timeout'u (saniye) geçirin.

PHP

use Digitload\WatchIP\WatchIP;
use Digitload\WatchIP\WatchIPError;

$client = new WatchIP('wip_pub_xxxxxxxx', origin: 'https://example.com');

try {
    $geo = $client->getGeo(['timeout' => 5.0]);
} catch (WatchIPError $err) {
    echo $err->getErrorCode(), ' ', $err->getStatus(), ' ', $err->getMessage();
}

Bu SDK'nın kapsamadıkları

Bu paket yalnızca GET /v1/geo'yu çağırır. IP sorgulama, e-posta doğrulama ve risk kontrolleri, henüz bir PHP istemcisi olmayan ayrı sunucudan sunucuya endpoint'lerdir — bunları, kimlik doğrulama kılavuzunun anlattığı şekilde kimliği doğrulanmış olarak doğrudan cURL ile çağırın.

İlgili sayfalar