Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το όνομά σας και ένα email ή έναν αριθμό τηλεφώνου. Θα σας στείλουμε πληροφορίες για την πρόσβαση στο Tajo.

Σε αυτή τη σελίδα

Ρύθμιση ταυτοποίησης

Το Brevo παρέχει δύο μεθόδους ταυτοποίησης ανάλογα με την περίπτωση χρήσης σας: ταυτοποίηση με κλειδί API για τυπική πρόσβαση στο API και ταυτοποίηση με διακριτικό MCP για ενσωματώσεις AI. Αυτός ο οδηγός καλύπτει και τις δύο μεθόδους.

Ταυτοποίηση με κλειδί API

Τα κλειδιά API του Brevo χρησιμοποιούνται για τυπική πρόσβαση REST API σε όλες τις υπηρεσίες του Brevo.

Δημιουργήστε το κλειδί API σας

Συνδεθείτε στον πίνακα ελέγχου του Brevo
Μεταβείτε στις Settings → API Keys
Κάντε κλικ στο Generate a New API Key
Δώστε στο κλειδί σας ένα περιγραφικό όνομα (π.χ. «My App Production»)
Αντιγράψτε και αποθηκεύστε το κλειδί με ασφάλεια (δεν θα το δείτε ξανά!)

Βέλτιστες πρακτικές ασφάλειας για τα κλειδιά API

✅ ΝΑ ΚΑΝΕΤΕ

Αποθηκεύετε τα κλειδιά με ασφάλεια χρησιμοποιώντας μεταβλητές περιβάλλοντος
Χρησιμοποιείτε διαφορετικά κλειδιά για ανάπτυξη και παραγωγή
Εναλλάσσετε τα κλειδιά τακτικά (συνιστάται κάθε 90 ημέρες)
Περιορίζετε τα δικαιώματα του κλειδιού μόνο σε ό,τι χρειάζεται
Παρακολουθείτε τη χρήση του κλειδιού στον πίνακα ελέγχου σας

❌ ΝΑ ΜΗΝ ΚΑΝΕΤΕ

Μην υποβάλλετε ποτέ κλειδιά σε σύστημα ελέγχου εκδόσεων
Μην ενσωματώνετε κλειδιά σταθερά στην εφαρμογή σας
Μην μοιράζεστε κλειδιά μέσω email ή chat
Μην χρησιμοποιείτε κλειδιά παραγωγής για δοκιμές

Μεταβλητές περιβάλλοντος

Αποθηκεύστε τα κλειδιά API σας ως μεταβλητές περιβάλλοντος:

Linux/macOS (.bashrc ή .zshrc)

export BREVO_API_KEY="your_api_key_here"

Windows (γραμμή εντολών)

set BREVO_API_KEY=your_api_key_here

Node.js (αρχείο .env)

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');

Κεφαλίδες ταυτοποίησης

Συμπεριλάβετε το κλειδί API σας στις κεφαλίδες του αιτήματος:

Τυπική μορφή κεφαλίδας

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

Παράδειγμα σε JavaScript

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)

Δικαιώματα και εμβέλειες κλειδιών

Διαφορετικά κλειδιά API μπορούν να έχουν διαφορετικά δικαιώματα:

Μόνο ανάγνωση: Επιτρέπονται μόνο αιτήματα GET
Αποστολή email: Δικαιώματα για συναλλακτικά email
Διαχείριση επαφών: Δημιουργία, ενημέρωση και διαγραφή επαφών
Διαχείριση καμπανιών: Δημιουργία και αποστολή καμπανιών
Πλήρης πρόσβαση: Όλα τα τελικά σημεία του API

Δοκιμή της ταυτοποίησής σας

Χρησιμοποιήστε αυτό το τελικό σημείο για να επαληθεύσετε ότι η ταυτοποίησή σας λειτουργεί:

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

Επιτυχής απόκριση (200 OK):

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

Σφάλμα ταυτοποίησης (401 Unauthorized):

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

Εναλλαγή κλειδιών

Για να εναλλάξετε το κλειδί API σας:

Δημιουργήστε ένα νέο κλειδί στον πίνακα ελέγχου
Ενημερώστε τις μεταβλητές περιβάλλοντος με το νέο κλειδί
Αναπτύξτε την εφαρμογή σας με το νέο κλειδί
Δοκιμάστε διεξοδικά για να βεβαιωθείτε ότι όλα λειτουργούν
Ανακαλέστε το παλιό κλειδί μόλις είστε σίγουροι για το νέο

Παρακολούθηση της χρήσης του κλειδιού API

Παρακολουθήστε τη χρήση του κλειδιού API σας στον πίνακα ελέγχου του Brevo:

Αιτήματα ανά ημέρα/μήνα
Ποσοστά σφαλμάτων ανά τελικό σημείο
Γεωγραφικά μοτίβα χρήσης
Ώρες αιχμής

Στρατηγική με πολλαπλά κλειδιά API

Για μεγαλύτερες εφαρμογές, εξετάστε τη χρήση πολλαπλών κλειδιών API:

Παραγωγή: Ζωντανά δεδομένα και email πελατών
Staging: Δοκιμές πριν από την παραγωγή
Ανάπτυξη: Τοπική ανάπτυξη και δοκιμές
Παρακολούθηση: Έλεγχοι υγείας και μετρήσεις
Τρίτοι: Εξωτερικές ενσωματώσεις

Ταυτοποίηση με διακριτικό MCP

Το Brevo Model Context Protocol (MCP) είναι ένα πλαίσιο ενσωμάτωσης AI που επιτρέπει σε βοηθούς AI να αλληλεπιδρούν με τις υπηρεσίες του Brevo. Το MCP χρησιμοποιεί ξεχωριστή μέθοδο ταυτοποίησης μέσω διακριτικών MCP.

Τι είναι το MCP;

Το MCP παρέχει τυποποιημένη πρόσβαση AI στα API του Brevo μέσω:

Μεταφορά: HTTPS
Βασικό URL: https://mcp.brevo.com/v1/
Μορφή απόκρισης: JSON
Ταυτοποίηση: Διακριτικό MCP (διαφορετικό από τα κλειδιά API)

Δημιουργήστε το διακριτικό MCP σας

Συνδεθείτε στον πίνακα ελέγχου του Brevo
Μεταβείτε στις Settings → MCP Tokens (ή στις ρυθμίσεις λογαριασμού)
Δημιουργήστε ένα νέο διακριτικό MCP
Αντιγράψτε και αποθηκεύστε το διακριτικό με ασφάλεια

Σημείωση: Το MCP είναι προς το παρόν διαθέσιμο μόνο σε χρήστες πρώιμης πρόσβασης.

Χρήση διακριτικών MCP

Τα διακριτικά MCP χρησιμοποιούνται ειδικά για ενσωματώσεις AI και συνδέσεις Model Context Protocol:

export BREVO_MCP_TOKEN="your_mcp_token_here"

Συμπεριλάβετε το διακριτικό MCP στα αιτήματα προς τα τελικά σημεία MCP:

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

MCP έναντι κλειδιού API

Χαρακτηριστικό	Κλειδί API	Διακριτικό MCP
Περίπτωση χρήσης	Τυπική πρόσβαση REST API	Ενσωμάτωση AI και συνδέσεις MCP
Βασικό URL	api.brevo.com	mcp.brevo.com
Κεφαλίδα	`api-key`	`Authorization: Bearer`
Διαθεσιμότητα	Όλοι οι χρήστες	Χρήστες πρώιμης πρόσβασης

Βέλτιστες πρακτικές ασφάλειας για το MCP

Αποθηκεύετε τα διακριτικά MCP ξεχωριστά από τα κλειδιά API
Χρησιμοποιείτε μεταβλητές περιβάλλοντος για την αποθήκευση διακριτικών
Εναλλάσσετε τα διακριτικά τακτικά
Μην υποβάλλετε ποτέ διακριτικά σε σύστημα ελέγχου εκδόσεων
Παρακολουθείτε τη χρήση του MCP στον πίνακα ελέγχου σας

Αντιμετώπιση προβλημάτων ταυτοποίησης

Συνήθη ζητήματα με τα κλειδιά API

Μη έγκυρη μορφή κλειδιού API

Τα κλειδιά πρέπει να έχουν ακριβώς 64 χαρακτήρες
Ελέγξτε για επιπλέον κενά ή χαρακτήρες

Σφάλμα δικαιωμάτων

Επαληθεύστε ότι το κλειδί σας έχει τα απαιτούμενα δικαιώματα
Ελέγξτε αν το κλειδί είναι ενεργό στον πίνακα ελέγχου σας

Όρια ρυθμού

Οι αποτυχίες ταυτοποίησης προσμετρώνται στα όρια ρυθμού
Περιμένετε πριν δοκιμάσετε ξανά με σωστά διαπιστευτήρια

Γεωγραφικοί περιορισμοί

Ορισμένοι λογαριασμοί έχουν περιορισμούς IP
Επικοινωνήστε με την υποστήριξη αν χρειάζεται να προσθέσετε διευθύνσεις IP σε λίστα επιτρεπόμενων

Συνήθη ζητήματα με τα διακριτικά MCP

Το MCP δεν είναι διαθέσιμο

Βεβαιωθείτε ότι έχετε πρώιμη πρόσβαση στις λειτουργίες MCP
Επικοινωνήστε με την υποστήριξη του Brevo για να ζητήσετε πρόσβαση

Μη έγκυρο διακριτικό

Επαληθεύστε ότι το διακριτικό αντιγράφηκε σωστά, χωρίς κενά
Ελέγξτε ότι το διακριτικό δεν έχει λήξει ούτε ανακληθεί

Λανθασμένο βασικό URL

Τα διακριτικά MCP λειτουργούν μόνο με το mcp.brevo.com
Μην χρησιμοποιείτε διακριτικά MCP με τελικά σημεία του api.brevo.com