Kimlik Doğrulama Kurulumu

Brevo, kullanım senaryonuza göre iki kimlik doğrulama yöntemi sunar: standart API erişimi için API anahtarı ile kimlik doğrulama ve yapay zekâ entegrasyonları için MCP token ile kimlik doğrulama. Bu kılavuz her iki yöntemi de kapsar.

API anahtarı ile kimlik doğrulama

Brevo API anahtarları, tüm Brevo hizmetlerine standart REST API erişimi için kullanılır.

API anahtarınızı oluşturun

1. Brevo yönetim panelinize giriş yapın
2. Ayarlar → API Keys bölümüne gidin
3. Generate a New API Key düğmesine tıklayın
4. Anahtarınıza açıklayıcı bir ad verin (örneğin “My App Production”)
5. Anahtarı kopyalayın ve güvenli biçimde saklayın (bir daha göremezsiniz)

API anahtarı güvenliği için en iyi uygulamalar

✅ YAPIN

• Anahtarları ortam değişkenleri kullanarak güvenli biçimde saklayın
• Geliştirme ve üretim için farklı anahtarlar kullanın
• Anahtarları düzenli olarak yenileyin (90 günde bir önerilir)
• Anahtar izinlerini yalnızca gerekli olanla sınırlayın
• Yönetim panelinizden anahtar kullanımını izleyin

❌ YAPMAYIN

• Anahtarları asla sürüm kontrolüne göndermeyin
• Anahtarları uygulamanızın içine sabit olarak yazmayın
• Anahtarları e-posta veya sohbet yoluyla paylaşmayın
• Test için üretim anahtarlarını kullanmayın

Ortam değişkenleri

API anahtarlarınızı ortam değişkeni olarak saklayın:

Linux/macOS (.bashrc veya .zshrc)

export BREVO_API_KEY="your_api_key_here"

Windows (Komut İstemi)

set BREVO_API_KEY=your_api_key_here

Node.js (.env dosyası)

BREVO_API_KEY=your_api_key_here

// Load from environment
const apiKey = process.env.BREVO_API_KEY;

Python

import os

api_key = os.getenv('BREVO_API_KEY')

PHP

$apiKey = $_ENV['BREVO_API_KEY'];
// or
$apiKey = getenv('BREVO_API_KEY');

Kimlik doğrulama başlıkları

API anahtarınızı istek başlıklarına ekleyin:

Standart başlık biçimi

GET /v3/account HTTP/1.1
Host: api.brevo.com
Accept: application/json
api-key: your_api_key_here

JavaScript örneği

const headers = {
  'Accept': 'application/json',
  'api-key': process.env.BREVO_API_KEY
};

fetch('https://api.brevo.com/v3/account', { headers })
  .then(response => response.json())
  .then(data => console.log(data));

Python Requests

import requests

headers = {
    'Accept': 'application/json',
    'api-key': os.getenv('BREVO_API_KEY')
}

response = requests.get('https://api.brevo.com/v3/account', headers=headers)

Anahtar izinleri ve kapsamları

Farklı API anahtarları farklı izinlere sahip olabilir:

• Salt okunur: Yalnızca GET isteklerine izin verilir
• E-posta gönderme: İşlemsel e-posta izinleri
• Kişileri yönetme: Kişi oluşturma, güncelleme, silme
• Kampanya yönetimi: Kampanya oluşturma ve gönderme
• Tam erişim: Tüm API uç noktaları

Kimlik doğrulamanızı test etme

Kimlik doğrulamanızın çalıştığını doğrulamak için bu uç noktayı kullanın:

curl -X GET "https://api.brevo.com/v3/account" \
  -H "Accept: application/json" \
  -H "api-key: $BREVO_API_KEY"

Başarılı yanıt (200 OK):

{
  "email": "[email protected]",
  "firstName": "John",
  "lastName": "Doe"
}

Kimlik doğrulama hatası (401 Unauthorized):

{
  "code": "unauthorized",
  "message": "Invalid API key provided"
}

Anahtar yenileme

API anahtarınızı yenilemek için:

1. Yönetim panelinde yeni bir anahtar oluşturun
2. Ortam değişkenlerinizi yeni anahtarla güncelleyin
3. Uygulamanızı yeni anahtarla dağıtın
4. Her şeyin çalıştığından emin olmak için kapsamlı test yapın
5. Yeni anahtardan emin olduğunuzda eski anahtarı iptal edin

API anahtarı kullanımını izleme

API anahtarı kullanımınızı Brevo yönetim panelinden izleyin:

• Gün/ay başına istek sayısı
• Uç nokta bazında hata oranları
• Coğrafi kullanım desenleri
• En yoğun kullanım saatleri

Çoklu API anahtarı stratejisi

Daha büyük uygulamalarda birden çok API anahtarı kullanmayı değerlendirin:

• Üretim: Canlı müşteri verileri ve e-postaları
• Hazırlık: Üretim öncesi testler
• Geliştirme: Yerel geliştirme ve test
• İzleme: Sağlık kontrolleri ve metrikler
• Üçüncü taraf: Dış entegrasyonlar

MCP token ile kimlik doğrulama

Brevo Model Context Protocol (MCP), yapay zekâ asistanlarının Brevo hizmetleriyle etkileşim kurmasını sağlayan bir yapay zekâ entegrasyon çerçevesidir. MCP, MCP token’ları üzerinden ayrı bir kimlik doğrulama yöntemi kullanır.

MCP nedir?

MCP, Brevo API’lerine standartlaştırılmış yapay zekâ erişimi sağlar:

• Aktarım: HTTPS
• Temel URL: https://mcp.brevo.com/v1/
• Yanıt biçimi: JSON
• Kimlik doğrulama: MCP token (API anahtarlarından farklıdır)

MCP token’ınızı oluşturun

1. Brevo yönetim panelinize giriş yapın
2. Ayarlar → MCP Tokens bölümüne (veya hesap ayarlarına) gidin
3. Yeni bir MCP token oluşturun
4. Token’ı kopyalayın ve güvenli biçimde saklayın

Not: MCP şu anda yalnızca erken erişim kullanıcıları için kullanılabilir.

MCP token’larını kullanma

MCP token’ları özellikle yapay zekâ entegrasyonları ve Model Context Protocol bağlantıları için kullanılır:

export BREVO_MCP_TOKEN="your_mcp_token_here"

MCP uç noktalarına gönderdiğiniz isteklere MCP token’ını ekleyin:

GET /v1/account HTTP/1.1
Host: mcp.brevo.com
Accept: application/json
Authorization: Bearer your_mcp_token_here

MCP ile API anahtarı karşılaştırması

MCP güvenliği için en iyi uygulamalar

• MCP token’larını API anahtarlarından ayrı saklayın
• Token saklamak için ortam değişkenleri kullanın
• Token’ları düzenli olarak yenileyin
• Token’ları asla sürüm kontrolüne göndermeyin
• MCP kullanımını yönetim panelinizden izleyin

Kimlik doğrulama sorunlarını giderme

Sık karşılaşılan API anahtarı sorunları

Geçersiz API anahtarı biçimi

• Anahtarlar tam olarak 64 karakter uzunluğunda olmalıdır
• Fazladan boşluk veya karakter olup olmadığını denetleyin

İzin hatası

• Anahtarınızın gerekli izinlere sahip olduğunu doğrulayın
• Anahtarın yönetim panelinizde etkin olup olmadığını denetleyin

Hız sınırlaması

• Başarısız kimlik doğrulamalar da hız sınırlarına dahil edilir
• Doğru kimlik bilgileriyle yeniden denemeden önce bekleyin

Coğrafi kısıtlamalar

• Bazı hesaplarda IP kısıtlamaları vardır
• IP adreslerini izin listesine eklemeniz gerekiyorsa destek ekibiyle iletişime geçin

Sık karşılaşılan MCP token sorunları

MCP kullanılamıyor

• MCP özelliklerine erken erişiminizin olduğundan emin olun
• Erişim talep etmek için Brevo destek ekibiyle iletişime geçin

Geçersiz token

• Token’ın boşluksuz ve eksiksiz kopyalandığını doğrulayın
• Token’ın süresinin dolmadığını veya iptal edilmediğini denetleyin

Yanlış temel URL

• MCP token’ları yalnızca mcp.brevo.com ile çalışır
• MCP token’larını api.brevo.com uç noktalarıyla kullanmayın

Sonraki adımlar

• Hız sınırları hakkında bilgi edinin
• Bir SDK kurun
• İlk API çağrınızı yapın