--- title: "API ključevi | Tajo" description: "Potpuni vodič za autentifikaciju API ključem uz Brevo" url: https://tajo.io/hr/docs/authentication/api-keys/ markdown: https://tajo.io/hr/docs/authentication/api-keys.md lang: hr-HR author: "Set Noa" author_url: https://tajo.io/hr/set-noa/ robots: noindex --- Zatražite rani pristup Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju. # API ključevi [Set Noa](https://tajo.io/hr/set-noa/) API ključevi glavna su metoda autentifikacije prema Brevo API-ju. Nude jednostavan i siguran način programskog pristupa vašem računu. ## Što su API ključevi? API ključevi jedinstveni su identifikatori koji autentificiraju vašu aplikaciju pri slanju zahtjeva Brevo API-ju. Svaki ključ niz je od 64 znaka koji služi i kao identifikator i kao lozinka. ``` Example API key: xkeysib-a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456-Ab1Cd2Ef3Gh4 ``` ## Generiranje API ključeva ### Vodič korak po korak 1. **Prijavite se u Brevo**: otvorite svoju [Brevo nadzornu ploču](https://app.brevo.com/) 2. **Idite na postavke**: kliknite na svoj profil → Settings 3. **Otvorite API ključeve**: odaberite „API Keys“ u lijevom izborniku 4. **Stvorite novi ključ**: kliknite „Generate a New API Key“ 5. **Imenujte ključ**: dajte mu opisno ime (npr. „Production App“, „Development Testing“) 6. **Postavite dopuštenja**: odaberite odgovarajuću razinu pristupa 7. **Generirajte**: kliknite „Generate“ i odmah kopirajte ključ ### Konvencije imenovanja API ključeva Koristite opisna imena koja vam pomažu prepoznati svrhu ključa: - `production-web-app` - `staging-environment` - `mobile-app-ios` - `webhook-listener` - `data-sync-service` ## Vrste API ključeva i dopuštenja ### Ključevi s 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štenje 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 ``` ### Primjeri 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 ``` ## Sigurnost API ključeva ### Sigurna pohrana **Varijable 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; ``` **Upravitelji tajni u oblaku** - AWS Secrets Manager - Google Secret Manager - Azure Key Vault - HashiCorp Vault ### Najbolje sigurnosne prakse 1. **Nikada ne kodirajte ključeve tvrdo** ```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. **Redovito mijenjajte ključeve** - Postavite podsjetnike u kalendaru za tromjesečnu zamjenu - Koristite alate za automatizaciju zamjene ključeva - Pripremite plan povratka na prethodno stanje 4. **Nadzirite korištenje ključeva** - Postavite upozorenja za neuobičajenu aktivnost - Mjesečno pregledavajte zapise o korištenju ključeva - Pratite geografske obrasce pristupa ## Upravljanje ključevima ### Nadzor aktivnih ključeva Nadzirite svoje aktivne ključeve na nadzornoj ploči: ``` Key Name: production-web-app Created: 2024-01-15 Last Used: 2024-01-20 14:30 UTC Requests Today: 1,247 Status: Active ``` ### Postupak zamjene ključa 1. **Generirajte novi ključ**: stvorite zamjenski ključ 2. **Ažurirajte konfiguraciju**: postavite izdanje s novim ključem 3. **Nadzirite**: provjerite radi li novi ključ ispravno 4. **Prijelazno razdoblje**: zadržite stari ključ aktivnim 24-48 sati 5. **Opozovite stari ključ**: izbrišite prethodni ključ ### Hitan opoziv ključa Ako je ključ kompromitiran: 1. **Trenutačni opoziv**: izbrišite ključ s nadzorne ploče 2. **Generirajte zamjenu**: odmah stvorite novi ključ 3. **Ažurirajte aplikacije**: što prije postavite izdanje s novim ključem 4. **Nadzirite aktivnost**: provjerite ima li neovlaštenog korištenja 5. **Izvještaj o incidentu**: dokumentirajte sigurnosni incident ## Ograničenja brzine i API ključevi Brevo ograničava zahtjeve po krajnjoj točki, a ne po danu. Na općoj razini, koju ima svaki plan, `POST /v3/smtp/email` dopušta 1.000 zahtjeva u sekundi, krajnje točke `/v3/contacts` 10 u sekundi i 36.000 na sat, a krajnje točke bez vlastitog ograničenja 100 na sat. Planovi Professional i Enterprise otključavaju više razine. Cijelu tablicu pogledajte u [Ograničenjima broja zahtjeva](https://tajo.io/hr/docs/rate-limits/). ### Zaglavlja s ograničenjem brzine ```http HTTP/1.1 200 OK x-sib-ratelimit-limit: 1000 x-sib-ratelimit-remaining: 750 x-sib-ratelimit-reset: 1 ``` ### Rukovanje ograničenjima brzine ```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; } } ``` ## Rješavanje problema s API ključevima ### Česte poruke o pogreškama **Neispravan API ključ (401)** ```json { "code": "unauthorized", "message": "Invalid API key provided" } ``` **Nedostatna dopuštenja (403)** ```json { "code": "permission_denied", "message": "API key does not have required permissions" } ``` **Prekoračeno ograničenje brzine (429)** ```json { "code": "too_many_requests", "message": "Rate limit exceeded for API key" } ``` ### Kontrolni popis za otklanjanje problema - Ključ je ispravno oblikovan (64 znaka) - Nema dodatnih razmaka ni skrivenih znakova - Ključ ima potrebna dopuštenja - Ključ je aktivan (nije opozvan) - Unutar ograničenja brzine - Koristi se ispravna krajnja točka API-ja - Zaglavlja su ispravno oblikovana ## Sljedeći koraci - [Saznajte više o OAuth 2.0](https://tajo.io/hr/docs/authentication/oauth/) - Upoznajte JWT tokene - [Istražite ograničenja brzine](https://tajo.io/hr/docs/rate-limits/) - [Isprobajte SDK-ove](https://tajo.io/hr/docs/sdks-libraries/)