Servis anahtarı

Kendi yazılımınızın WiChat API’sine erişmesi için servis anahtarı kullanılır. Anahtar, hangi IP’lerden ve hangi uçlara erişileceğiyle sınırlandırılır.

Servis anahtarı nedir?

Servis anahtarı, sunucudan sunucuya erişim içindir. Bir operatörün oturumu değil, bir yazılımın kimliğidir. Üç şeyle sınırlanır:

• İzinli IP adresleri — anahtar yalnızca bu adreslerden kullanılabilir
• İzinli uç noktalar — anahtar yalnızca bu uçlara erişebilir
• Durum — anahtar aktif veya pasif olabilir

Anahtar oluşturma

Entegrasyon — Servis Anahtarı

Anahtar oluştururken doldurulacak alanlar:

IP tanımlama biçimleri

İzinli IP alanında üç biçim kullanabilirsiniz:

Uç nokta yetkisi

Anahtarın erişebileceği API yollarını belirlersiniz. Yalnızca gerçekten gereken uçları ekleyin — kullanılmayan bir yetki gereksiz risktir.

Anahtarı saklama

Anahtar oluşturulduğunda svc_ ile başlayan uzun bir metin üretilir:

svc_••••••••••••••••••••••••••••••••••••••••

Anahtarı nerede saklamalı:

• Sunucunuzda ortam değişkeni olarak
• Bir gizli anahtar yöneticisinde

Nerede saklamamalı: kod deposunda, yapılandırma dosyasında düz metin olarak, e-postada, mesajlaşma uygulamasında, dokümanda.

Anahtarı kullanma

İstek gönderirken anahtarı X-Service-Key başlığında iletirsiniz:

curl -X POST "https://chat.wi.tr/chat-gateway/admin/ORNEK-UC" \
  -H "X-Service-Key: svc_••••••••" \
  -H "Content-Type: application/json" \
  -d '{"ornek_alan": "ornek_deger"}'

Yanıtlar tutarlı bir biçimde döner:

{
  "status": "success",
  "data": { }
}

Kullanım izleme

Anahtarların kullanımı kayıt altına alınır. Hangi anahtarın ne zaman ve hangi uca eriştiği görülebilir; anahtar kartında son kullanım zamanı gösterilir.

Anahtar iptal ve yenileme

Sorun giderme