--- title: "API ključevi | Tajo" description: "Kompletan vodič za autentifikaciju pomoću API ključa sa Brevom" url: https://tajo.io/sr/docs/authentication/api-keys/ markdown: https://tajo.io/sr/docs/authentication/api-keys.md lang: sr-Latn-RS author: "Set Noa" author_url: https://tajo.io/sr/set-noa/ robots: noindex --- Zatražite rani pristup Unesite ime i poslovnu adresu e-pošte. Poslaćemo vam vezu za potvrdu zahteva za pristup Taju. # API ključevi [Set Noa](https://tajo.io/sr/set-noa/) API ključevi su primarni metod za autentifikaciju na Brevo API. Oni pružaju jednostavan i bezbedan način da programski pristupite svom nalogu. ## Šta su API ključevi? API ključevi su jedinstveni identifikatori koji autentifikuju vašu aplikaciju kada šalje zahteve Brevo API-ju. Svaki ključ je niz od 64 znaka koji služi i kao identifikator i kao lozinka. ``` Example API key: xkeysib-a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456-Ab1Cd2Ef3Gh4 ``` ## Generisanje API ključeva ### Vodič korak po korak 1. **Prijavite se na Brevo**: Otvorite svoju [Brevo komandnu tablu](https://app.brevo.com/) 2. **Idite na podešavanja**: Kliknite na svoj profil → Settings 3. **Otvorite API ključeve**: Izaberite „API Keys” iz levog menija 4. **Kreirajte novi ključ**: Kliknite na „Generate a New API Key” 5. **Imenujte svoj ključ**: Dajte mu opisan naziv (na primer „Production App”, „Development Testing”) 6. **Podesite dozvole**: Izaberite odgovarajući nivo pristupa 7. **Generišite**: Kliknite na „Generate” i odmah kopirajte ključ ### Konvencije imenovanja API ključeva Koristite opisne nazive koji vam pomažu da prepoznate namenu ključa: - `production-web-app` - `staging-environment` - `mobile-app-ios` - `webhook-listener` - `data-sync-service` ## Tipovi API ključeva i dozvole ### Ključevi sa punim pristupom ``` Permissions: All API endpoints Use cases: Complete application integration Risk level: High - protect carefully ``` ### Ključevi samo za čitanje ``` Permissions: GET requests only Use cases: Analytics, reporting, dashboards Risk level: Low - limited access ``` ### Ključevi samo za slanje ``` Permissions: Transactional email sending Use cases: Application notifications, receipts Risk level: Medium - can send emails ``` ### Ključevi za upravljanje kontaktima ``` Permissions: Contact CRUD operations Use cases: CRM integrations, form submissions Risk level: Medium - data modification ``` ## Korišćenje API ključeva ### Autentifikacija zaglavljem Uključite svoj API ključ u zaglavlje `api-key`: ```http GET /v3/account HTTP/1.1 Host: api.brevo.com Accept: application/json Content-Type: application/json api-key: YOUR_API_KEY ``` ### Primeri koda #### JavaScript/Node.js ```javascript const brevo = require('@getbrevo/brevo'); const apiInstance = new brevo.AccountApi(); apiInstance.setApiKey(brevo.AccountApiApiKeys.apiKey, process.env.BREVO_API_KEY); // Make authenticated request apiInstance.getAccount() .then(data => console.log('Account info:', data)) .catch(error => console.error('Error:', error)); ``` #### Python ```python import sib_api_v3_sdk from sib_api_v3_sdk.rest import ApiException # Configure API key configuration = sib_api_v3_sdk.Configuration() configuration.api_key['api-key'] = 'YOUR_API_KEY' # Create API instance api_instance = sib_api_v3_sdk.AccountApi(sib_api_v3_sdk.ApiClient(configuration)) try: # Get account info api_response = api_instance.get_account() print(api_response) except ApiException as e: print("Exception when calling AccountApi->get_account: %s\n" % e) ``` #### PHP ```php setApiKey('api-key', 'YOUR_API_KEY'); // Create API instance $apiInstance = new SendinBlue\Client\Api\AccountApi( new GuzzleHttp\Client(), $config ); try { $result = $apiInstance->getAccount(); print_r($result); } catch (Exception $e) { echo 'Exception when calling AccountApi->getAccount: ', $e->getMessage(), PHP_EOL; } ?> ``` #### Ruby ```ruby require 'sib-api-v3-sdk' # Configure API key SibApiV3Sdk.configure do |config| config.api_key['api-key'] = 'YOUR_API_KEY' end # Create API instance api_instance = SibApiV3Sdk::AccountApi.new begin # Get account info result = api_instance.get_account puts result rescue SibApiV3Sdk::ApiError => e puts "Exception when calling AccountApi->get_account: #{e}" end ``` ## Bezbednost API ključeva ### Bezbedno čuvanje **Promenljive okruženja** (preporučeno) ```bash # .env file BREVO_API_KEY=xkeysib-your-api-key-here # Usage in code const apiKey = process.env.BREVO_API_KEY; ``` **Menadžeri tajni u oblaku** - AWS Secrets Manager - Google Secret Manager - Azure Key Vault - HashiCorp Vault ### Najbolje bezbednosne prakse 1. **Nikada nemojte upisivati ključeve direktno u kod** ```javascript // ❌ Bad - hardcoded const apiKey = "xkeysib-a1b2c3d4..."; // ✅ Good - environment variable const apiKey = process.env.BREVO_API_KEY; ``` 2. **Koristite različite ključeve po okruženju** ``` Production: BREVO_API_KEY_PROD Staging: BREVO_API_KEY_STAGING Development: BREVO_API_KEY_DEV ``` 3. **Redovno menjajte ključeve** - Postavite podsetnike u kalendaru za tromesečnu zamenu - Koristite alate za automatizaciju zamene ključeva - Pripremite plan za vraćanje na prethodno stanje 4. **Pratite korišćenje ključeva** - Podesite upozorenja za neuobičajenu aktivnost - Pregledajte dnevnike korišćenja ključeva jednom mesečno - Pratite geografske obrasce pristupa ## Upravljanje ključevima ### Praćenje aktivnih ključeva Pratite svoje aktivne ključeve na komandnoj tabli: ``` Key Name: production-web-app Created: 2024-01-15 Last Used: 2024-01-20 14:30 UTC Requests Today: 1,247 Status: Active ``` ### Proces zamene ključa 1. **Generišite novi ključ**: Kreirajte zamenski ključ 2. **Ažurirajte konfiguraciju**: Postavite u produkciju sa novim ključem 3. **Pratite**: Uverite se da novi ključ radi ispravno 4. **Period tolerancije**: Zadržite stari ključ aktivnim 24 do 48 sati 5. **Opozovite stari ključ**: Obrišite prethodni ključ ### Hitno opozivanje ključa Ako je ključ kompromitovan: 1. **Trenutno opozivanje**: Obrišite ključ sa komandne table 2. **Generišite zamenu**: Odmah kreirajte novi ključ 3. **Ažurirajte aplikacije**: Postavite u produkciju sa novim ključem što pre 4. **Pratite aktivnost**: Proverite da li je bilo neovlašćenog korišćenja 5. **Izveštaj o incidentu**: Dokumentujte bezbednosni incident ## Ograničenja broja zahteva i API ključevi Brevo ograničava zahteve po endpointu, a ne po danu. Na opštem nivou, koji ima svaki plan, `POST /v3/smtp/email` dozvoljava 1.000 zahteva u sekundi, endpointi `/v3/contacts` 10 u sekundi i 36.000 na sat, a endpointi bez sopstvenog ograničenja 100 na sat. Planovi Professional i Enterprise otključavaju više nivoe. Celu tabelu pogledajte u [Ograničenjima broja zahteva](https://tajo.io/sr/docs/rate-limits/). ### Zaglavlja ograničenja broja zahteva ```http HTTP/1.1 200 OK x-sib-ratelimit-limit: 1000 x-sib-ratelimit-remaining: 750 x-sib-ratelimit-reset: 1 ``` ### Rukovanje ograničenjima broja zahteva ```javascript async function makeApiCall() { try { const response = await fetch(url, { headers }); if (response.status === 429) { // Seconds until the window resets const waitTime = Number(response.headers.get('x-sib-ratelimit-reset') || 1); console.log(`Rate limited. Waiting ${waitTime} seconds`); await new Promise(resolve => setTimeout(resolve, waitTime * 1000)); // Retry the request return makeApiCall(); } return response.json(); } catch (error) { console.error('API call failed:', error); throw error; } } ``` ## Rešavanje problema sa API ključevima ### Česte poruke o greškama **Nevažeći API ključ (401)** ```json { "code": "unauthorized", "message": "Invalid API key provided" } ``` **Nedovoljne dozvole (403)** ```json { "code": "permission_denied", "message": "API key does not have required permissions" } ``` **Prekoračeno ograničenje broja zahteva (429)** ```json { "code": "too_many_requests", "message": "Rate limit exceeded for API key" } ``` ### Kontrolna lista za otklanjanje grešaka - Ključ je ispravno formatiran (64 znaka) - Nema suvišnih razmaka ni skrivenih znakova - Ključ ima potrebne dozvole - Ključ je aktivan (nije opozvan) - U okviru ste ograničenja broja zahteva - Koristite ispravnu API krajnju tačku - Zaglavlja su ispravno formatirana ## Sledeći koraci - [Saznajte više o OAuth 2.0](https://tajo.io/sr/docs/authentication/oauth/) - Upoznajte se sa JWT tokenima - [Istražite ograničenja broja zahteva](https://tajo.io/sr/docs/rate-limits/) - [Isprobajte SDK-ove](https://tajo.io/sr/docs/sdks-libraries/)