--- title: "API klíče | Tajo" description: "Kompletní průvodce autentizací pomocí API klíčů v Brevo" url: https://tajo.io/cz/docs/authentication/api-keys/ markdown: https://tajo.io/cz/docs/authentication/api-keys.md lang: cs-CZ author: "Set Noa" author_url: https://tajo.io/cz/set-noa/ robots: noindex --- Požádejte o přednostní přístup Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo. # API klíče [Set Noa](https://tajo.io/cz/set-noa/) API klíče jsou hlavní metodou autentizace vůči Brevo API. Nabízejí jednoduchý a bezpečný způsob, jak programově přistupovat k Vašemu účtu. ## Co jsou API klíče? API klíče jsou jedinečné identifikátory, které ověřují Vaši aplikaci při odesílání požadavků na Brevo API. Každý klíč je řetězec o 64 znacích, který slouží zároveň jako identifikátor i jako heslo. ``` Example API key: xkeysib-a1b2c3d4e5f6789012345678901234567890abcdef1234567890abcdef123456-Ab1Cd2Ef3Gh4 ``` ## Generování API klíčů ### Průvodce krok za krokem 1. **Přihlaste se do Brevo**: Otevřete svůj [Brevo dashboard](https://app.brevo.com/) 2. **Přejděte do nastavení**: Klikněte na svůj profil → Settings 3. **Otevřete API klíče**: V levém menu vyberte „API Keys“ 4. **Vytvořte nový klíč**: Klikněte na „Generate a New API Key“ 5. **Pojmenujte klíč**: Zvolte popisný název (například „Production App“, „Development Testing“) 6. **Nastavte oprávnění**: Vyberte odpovídající úroveň přístupu 7. **Vygenerujte**: Klikněte na „Generate“ a klíč si ihned zkopírujte ### Konvence pojmenování API klíčů Používejte popisné názvy, podle kterých snadno poznáte účel klíče: - `production-web-app` - `staging-environment` - `mobile-app-ios` - `webhook-listener` - `data-sync-service` ## Typy API klíčů a oprávnění ### Klíče s plným přístupem ``` Permissions: All API endpoints Use cases: Complete application integration Risk level: High - protect carefully ``` ### Klíče jen pro čtení ``` Permissions: GET requests only Use cases: Analytics, reporting, dashboards Risk level: Low - limited access ``` ### Klíče jen pro odesílání ``` Permissions: Transactional email sending Use cases: Application notifications, receipts Risk level: Medium - can send emails ``` ### Klíče pro správu kontaktů ``` Permissions: Contact CRUD operations Use cases: CRM integrations, form submissions Risk level: Medium - data modification ``` ## Používání API klíčů ### Autentizace v hlavičce Vložte svůj API klíč do hlavičky `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 ``` ### Ukázky kódu #### 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 ``` ## Zabezpečení API klíčů ### Bezpečné uložení **Proměnné prostředí** (doporučeno) ```bash # .env file BREVO_API_KEY=xkeysib-your-api-key-here # Usage in code const apiKey = process.env.BREVO_API_KEY; ``` **Cloudoví správci tajemství** - AWS Secrets Manager - Google Secret Manager - Azure Key Vault - HashiCorp Vault ### Doporučené bezpečnostní postupy 1. **Nikdy nezapisujte klíče natvrdo do kódu** ```javascript // ❌ Bad - hardcoded const apiKey = "xkeysib-a1b2c3d4..."; // ✅ Good - environment variable const apiKey = process.env.BREVO_API_KEY; ``` 2. **Pro každé prostředí používejte jiný klíč** ``` Production: BREVO_API_KEY_PROD Staging: BREVO_API_KEY_STAGING Development: BREVO_API_KEY_DEV ``` 3. **Pravidelně klíče obměňujte** - Nastavte si v kalendáři připomínku na čtvrtletní obměnu - Pro obměnu klíčů využijte automatizační nástroje - Mějte připravený plán pro návrat k původnímu stavu 4. **Sledujte využití klíčů** - Nastavte si upozornění na neobvyklou aktivitu - Každý měsíc procházejte logy využití klíčů - Sledujte, z jakých zemí přístupy přicházejí ## Správa klíčů ### Sledování aktivních klíčů Aktivní klíče sledujte v dashboardu: ``` Key Name: production-web-app Created: 2024-01-15 Last Used: 2024-01-20 14:30 UTC Requests Today: 1,247 Status: Active ``` ### Postup obměny klíče 1. **Vygenerujte nový klíč**: Vytvořte náhradní klíč 2. **Aktualizujte konfiguraci**: Nasaďte aplikaci s novým klíčem 3. **Sledujte provoz**: Ověřte, že nový klíč funguje správně 4. **Přechodné období**: Ponechte starý klíč aktivní 24 až 48 hodin 5. **Zrušte starý klíč**: Předchozí klíč smažte ### Nouzové zrušení klíče Pokud dojde ke kompromitaci klíče: 1. **Okamžité zrušení**: Smažte klíč v dashboardu 2. **Vytvoření náhrady**: Ihned vygenerujte nový klíč 3. **Aktualizace aplikací**: Co nejrychleji nasaďte nový klíč 4. **Kontrola aktivity**: Ověřte, zda nedošlo k neoprávněnému použití 5. **Hlášení incidentu**: Zdokumentujte bezpečnostní incident ## Omezení frekvence a API klíče Brevo omezuje požadavky podle endpointu, nikoli podle dne. Na obecné úrovni, kterou má každý tarif, umožňuje `POST /v3/smtp/email` 1 000 požadavků za sekundu, endpointy `/v3/contacts` 10 za sekundu a 36 000 za hodinu a endpointy bez vlastního limitu 100 za hodinu. Tarify Professional a Enterprise odemykají vyšší úrovně. Úplnou tabulku najdete v části [Limity požadavků](https://tajo.io/cz/docs/rate-limits/). ### Hlavičky s limity požadavků ```http HTTP/1.1 200 OK x-sib-ratelimit-limit: 1000 x-sib-ratelimit-remaining: 750 x-sib-ratelimit-reset: 1 ``` ### Práce s limity požadavků ```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; } } ``` ## Řešení potíží s API klíči ### Časté chybové zprávy **Neplatný API klíč (401)** ```json { "code": "unauthorized", "message": "Invalid API key provided" } ``` **Nedostatečná oprávnění (403)** ```json { "code": "permission_denied", "message": "API key does not have required permissions" } ``` **Překročený limit požadavků (429)** ```json { "code": "too_many_requests", "message": "Rate limit exceeded for API key" } ``` ### Kontrolní seznam pro ladění - Klíč má správný formát (64 znaků) - Žádné mezery navíc ani skryté znaky - Klíč má potřebná oprávnění - Klíč je aktivní (nebyl zrušen) - Jste v mezích limitu požadavků - Používáte správný API endpoint - Hlavičky mají správný formát ## Další kroky - [Seznamte se s OAuth 2.0](https://tajo.io/cz/docs/authentication/oauth/) - Porozumějte tokenům JWT - [Prozkoumejte limity požadavků](https://tajo.io/cz/docs/rate-limits/) - [Vyzkoušejte SDK](https://tajo.io/cz/docs/sdks-libraries/)