Z-Mask kişisel veri maskeleme API’si

Hesaba özel API anahtarı oluşturun

Çalışma alanına giriş yapın ve Z-Mask API anahtarı oluşturmak için API ve servis bölümünü açın. Anahtarı sunucunuzun gizli bilgi yöneticisinde veya ortam değişkeninde saklayıp Bearer belirteci olarak gönderin. Artık gerekmeyen anahtarları iptal edin.

API anahtarlarını tarayıcı paketlerine, URL’lere, herkese açık depolara veya günlüklere eklemeyin. İstekler anahtar sahibinin hesap yetkileri ve geçerli kullanım sınırlarıyla çalışır. Aşağıdaki örnekler gerçek giriş bilgileri yerine kurmaca girdi ve ortam değişkeni kullanır.

Sunucunuzdan metin maskeleyin

POST /v1/mask adresine text alanı içeren JSON gönderin. Metni başka bir sisteme iletmeden önce dönen sonucu ve tespit edilen alanları inceleyin. Entegrasyonu kurarken sentetik test verisi kullanın.

curl "https://api.zmask.zcntech.com/functions/v1/masking-gateway/v1/mask" \
  -H "Authorization: Bearer $ZMASK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Elif Şahin ile elif.sahin@example.com adresinden iletişime geçin."}'

Sayfa bakiyesini kontrol edin

Belge işleme isteği göndermeden önce hesabın sayfa bakiyesini görmek için aynı anahtarla GET /v1/balance çağrısı yapın. Bakiye sorgusu kredi ayırmaz; eşzamanlı istekler kullanılabilir bakiyeyi değiştirebilir.

curl "https://api.zmask.zcntech.com/functions/v1/masking-gateway/v1/balance" \
  -H "Authorization: Bearer $ZMASK_API_KEY"

Verileri açığa çıkarmadan hataları yönetin

Yanıtı kullanmadan önce HTTP durum kodlarını kontrol edin. Süresi dolmuş veya iptal edilmiş anahtarları, yetersiz krediyi ve işleme hatalarını uygulamanızda yönetin. Zaman aşımından sonra ücretli belge gönderimlerini kontrol etmeden tekrarlamayın.

İstek gövdelerini ve orijinal belgeleri analiz ve hata günlüklerine kaydetmeyin. Belge işleme sorunlarını araştırırken hesabın İşlem geçmişini inceleyin. Kurumsal ağ veya saklama gereksinimleri için kurum içi kurulumu ekibimizle görüşün.