API anahtarları: oluşturma, kullanım ve iptal

Yayınlandı · Güncellendi

Kendi verilerinizi, CRM'inizi ve AI asistanlarınızı hesabınızın yetkileriyle bağlayın.

  1. API anahtarları bölümünde entegrasyona anlaşılır bir ad verin. En fazla 10 aktif anahtar olabilir. Tam anahtarı ilk gösterildiğinde kopyalayın; sonradan tekrar gösterilmez, listede maskeli bilgiler bulunur.

  2. Güvenli sunucunuzdan https://api.activationking.com adresine Authorization: Bearer YOUR_API_KEY gönderin. Hesap ve organizasyon kimlikleri için GET /v1/me ile başlayın. Anahtarı tarayıcıda, URL'de, ekran görüntüsünde veya destek mesajında paylaşmayın.

  3. Belgelenmiş GET uçları abonelik, kredi, etkinlik, oturum, sonuç medyası, istatistik ve lead/anket yanıtlarınızı sunar. Listeler items, nextCursor ve totalCount döndürür. nextCursor null olana kadar cursor olarak gönderin; limit en fazla 100'dür. Saatler UTC, JSON alanları camelCase biçimindedir.

  4. Ops Calendar şirketleri, işleri ve teklifleri anahtar sahibinin rol yetkileri ve aktif organizasyon erişimiyle okur/yazar. /v1/me içindeki kimlikle X-Organization-Id gönderin. Önce referans verilerini okuyun. PUT /v1/ops/companies/external/{source}/{externalId} ve jobs karşılığı tekrar aktarımda aynı kaydı günceller. Yazma ve silme gerçek veriyi değiştirir; önce açık onay alın.

  5. Etkinlik ayarlarında PATCH öncesi GET /v1/settings/catalog ve GET /v1/events/{eventId}/settings okuyun. Yalnız belgelenmiş anahtar/türler kabul edilir; null ayarı varsayılana döndürür, geçersiz girdide hiçbir ayar kaydedilmez. Kiosk sonraki eşitlemede alır. Ops PATCH'te ise eksik/null alan değişmez ve gönderilen liste tüm listenin yerini alır: null kuralları farklıdır.

  6. Anahtar başına dakikada 300 istek sınırı vardır. X-RateLimit-Limit ve X-RateLimit-Remaining başlıklarını okuyun; 429 için Retry-After saniye bekleyin. Hata kodunu kontrol edin: 401 kimlik doğrulama, 403 erişim, 404 bulunamayan/erişilemeyen kayıt, Ops 402 aktif organizasyon erişiminin olmaması. İptal edilmiş anahtarı sürekli denemeyin.

  7. AI asistanları Streamable HTTP ile https://api.activationking.com/mcp adresine aynı Bearer anahtarı, sınırlar ve rol yetkileriyle bağlanır. MCP yazma araçları gerçek veriyi değiştirir ve açık onay gerektirir. Aşağıdaki kısa/tam Markdown referansları ve OpenAPI şeması güncel alanları, uçları ve araçları içerir.

  8. Anahtar kaybolduysa veya açığa çıktıysa iptal edip yenisini oluşturun ve entegrasyonu güncelleyin. İptal edilen anahtar çalışmaz. Destek amaçlı hesap görüntüleme sırasında anahtar oluşturulamaz veya iptal edilemez.

Bunlar genel kullanım adımlarıdır. Kullanılabilir işlemleri hesabınızın güncel izinleri, etkin özellikleri ve doğrulanmış işlem durumu belirler.

Bu makale işine yaradı mı?

Nereden başlayacağını mı bilemedin? Yardımcı olalım.

Projenizi anlatın. Bir sonraki adımı ekibimizle birlikte planlayın.

Göndererek Kullanım Koşulları'nı ve Gizlilik Politikası'nı kabul edersin.