Genel Bakış/OpenAPI/Kimlik Doğrulaması

Kimlik Doğrulaması

API anahtarınızı güvenli bir şekilde yapılandırın ve doğrulayın.

API anahtarları

GET /Health hariç her KPainter OpenAPI son noktası, kullanıcının API anahtarını kullanır:

Authorization: Bearer <your_api_key>

Bir anahtarı etkinleştirin ve kopyalayın API Anahtar Sayfa.

Öncelikle bağlantıyı kontrol edin

curl -s "https://api.kpainter.ai/openapi/v1/me" \  -H "Authorization: Bearer $KPAINTER_API_KEY"

Başarılı bir cevap, güvenli bir hesap ve plan özetini geri getirir. İçeriği oluşturmadan önce bunu kontrol edin.

Anahtarlar güvenli

  • Her anahtarı sunucu tarafındaki gizli bir mağazada veya güvenilir bir ajan bağlantısında tutun.
  • Hiçbir zaman bir anahtarı tarayıcı koduna, bir mobil paketine, bir ekran görüntüsüne veya günlüklere koymayın.
  • Bağımsız kullanıcılar için tek bir paylaşım anahtarı kullanmayın.
  • Hiçbir zaman hata mesajında tam anahtarı ekleyin.
  • Kullanıcıya bir anahtar yeniden ayarlandıktan sonra yeniden bağlanmasını isteyin.

Ortak Cevaplar

  • 401: Anahtar eksik, geçersiz veya etkisiz.
  • 403: Hesap istenen kapasiteyi kullanamaz.
  • 422: Bir alan veya parametreler kombinasyonu geçersizdir.
  • 429: İstekler çok sık; emekli olmadan önce yanıt talimatını takip edin.
  • Yeterli denge: oluşturma bir duraklama, tahmini krediler ve mevcut bir eylem bildirir. Bir duplikat oluşturmayın.

API anahtarı etkinleştirme, yeniden ayarlama ve silme KPainter web sitesinde kalır; OpenAPI anahtarları yönetmez.