Zatražite rani pristup

Unesite ime i imejl adresu ili broj telefona. Poslaćemo vam detalje o pristupu platformi Tajo.

Podešavanje autentifikacije

Brevo nudi dva načina autentifikacije, u zavisnosti od toga šta gradite: autentifikaciju API ključem za standardni pristup API-ju i autentifikaciju MCP tokenom za AI integracije. Ovo uputstvo pokriva oba načina.

Autentifikacija API ključem

Brevo API ključevi koriste se za standardni pristup REST API-ju svim Brevo uslugama.

Generišite svoj API ključ

Prijavite se u svoju Brevo komandnu tablu
Idite na Settings → API Keys
Kliknite na Generate a New API Key
Dajte ključu opisno ime (na primer „My App Production”)
Kopirajte i sačuvajte ključ na bezbedno mesto (nećete ga videti ponovo!)

Najbolje prakse za bezbednost API ključa

✅ RADITE

Čuvajte ključeve bezbedno pomoću promenljivih okruženja
Koristite različite ključeve za razvoj i produkciju
Redovno menjajte ključeve (preporučuje se na svakih 90 dana)
Ograničite dozvole ključa samo na ono što je neophodno
Pratite korišćenje ključa u svojoj komandnoj tabli

❌ NE RADITE

Nikada ne postavljajte ključeve u sistem za kontrolu verzija
Nemojte da upisujete ključeve direktno u kod svoje aplikacije
Nemojte da delite ključeve putem imejla ili četa
Nemojte da koristite produkcijske ključeve za testiranje

Promenljive okruženja

Čuvajte svoje API ključeve kao promenljive okruženja:

Linux/macOS (.bashrc ili .zshrc)

export BREVO_API_KEY="your_api_key_here"

Windows (Command Prompt)

set BREVO_API_KEY=your_api_key_here

Node.js (.env fajl)

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

Zaglavlja za autentifikaciju

Uključite svoj API ključ u zaglavlja zahteva:

Standardni format zaglavlja

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

Primer u JavaScript-u

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)

Dozvole i opsezi ključa

Različiti API ključevi mogu imati različite dozvole:

Samo čitanje: dozvoljeni su samo GET zahtevi
Slanje imejlova: dozvole za transakcione imejlove
Upravljanje kontaktima: kreiranje, ažuriranje i brisanje kontakata
Upravljanje kampanjama: kreiranje i slanje kampanja
Pun pristup: sve API krajnje tačke

Testiranje autentifikacije

Koristite ovu krajnju tačku da proverite da li autentifikacija radi:

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

Uspešan odgovor (200 OK):

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

Greška u autentifikaciji (401 Unauthorized):

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

Zamena ključa

Da biste zamenili svoj API ključ:

Generišite novi ključ u komandnoj tabli
Ažurirajte svoje promenljive okruženja novim ključem
Postavite svoju aplikaciju sa novim ključem
Detaljno testirajte kako biste bili sigurni da sve radi
Opozovite stari ključ kada budete sigurni u novi

Praćenje korišćenja API ključa

Pratite korišćenje svog API ključa u Brevo komandnoj tabli:

Broj zahteva po danu/mesecu
Stope grešaka po krajnjoj tački
Geografski obrasci korišćenja
Vremena najvećeg opterećenja

Strategija sa više API ključeva

Za veće aplikacije razmotrite korišćenje više API ključeva:

Produkcija: podaci o stvarnim kupcima i imejlovi
Staging: testiranje pre produkcije
Razvoj: lokalni razvoj i testiranje
Nadzor: provere ispravnosti i metrike
Treća lica: eksterne integracije

Autentifikacija MCP tokenom

Brevo Model Context Protocol (MCP) je okvir za AI integraciju koji omogućava AI asistentima da rade sa Brevo uslugama. MCP koristi zaseban način autentifikacije, preko MCP tokena.

Šta je MCP?

MCP obezbeđuje standardizovan AI pristup Brevo API-jima kroz:

Transport: HTTPS
Osnovni URL: https://mcp.brevo.com/v1/
Format odgovora: JSON
Autentifikacija: MCP token (razlikuje se od API ključeva)

Generišite svoj MCP token

Prijavite se u svoju Brevo komandnu tablu
Idite na Settings → MCP Tokens (ili u podešavanja naloga)
Generišite novi MCP token
Kopirajte i sačuvajte token na bezbedno mesto

Napomena: MCP je trenutno dostupan samo korisnicima sa ranim pristupom.

Korišćenje MCP tokena

MCP tokeni koriste se isključivo za AI integracije i veze preko protokola Model Context Protocol:

export BREVO_MCP_TOKEN="your_mcp_token_here"

Uključite MCP token u zahteve prema MCP krajnjim tačkama:

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

MCP u odnosu na API ključ

Funkcija	API ključ	MCP token
Primena	Standardni pristup REST API-ju	AI integracije i MCP veze
Osnovni URL	api.brevo.com	mcp.brevo.com
Zaglavlje	`api-key`	`Authorization: Bearer`
Dostupnost	Svi korisnici	Korisnici sa ranim pristupom

Najbolje prakse za bezbednost MCP-a

Čuvajte MCP tokene odvojeno od API ključeva
Koristite promenljive okruženja za čuvanje tokena
Redovno menjajte tokene
Nikada ne postavljajte tokene u sistem za kontrolu verzija
Pratite korišćenje MCP-a u svojoj komandnoj tabli

Rešavanje problema sa autentifikacijom

Uobičajeni problemi sa API ključem

Neispravan format API ključa

Ključevi treba da imaju tačno 64 znaka
Proverite da nema suvišnih razmaka ili znakova

Greška u dozvolama

Proverite da li vaš ključ ima potrebne dozvole
Proverite da li je ključ aktivan u vašoj komandnoj tabli

Ograničenje broja zahteva

Neuspele autentifikacije se računaju u ograničenje broja zahteva
Sačekajte pre nego što ponovo pokušate sa ispravnim akreditivima

Geografska ograničenja

Neki nalozi imaju ograničenja po IP adresi
Obratite se podršci ako treba da dodate IP adrese na listu dozvoljenih

Uobičajeni problemi sa MCP tokenom

MCP nije dostupan

Uverite se da imate rani pristup MCP funkcijama
Obratite se Brevo podršci da biste zatražili pristup

Neispravan token

Proverite da li je token kopiran ispravno, bez razmaka
Proverite da token nije istekao niti opozvan

Pogrešan osnovni URL

MCP tokeni rade samo sa mcp.brevo.com
Nemojte da koristite MCP tokene sa krajnjim tačkama na api.brevo.com