Pierwsze wywołanie API
Wykonajmy Twoje pierwsze wywołanie API, aby sprawdzić, czy konfiguracja API Brevo działa poprawnie.
Wymagania wstępne
- Konto Brevo
- Klucz API z Twojego panelu
- Narzędzie do wysyłania zapytań HTTP (curl, Postman lub podobne)
Pobierz informacje o koncie
Najprostsze pierwsze wywołanie to pobranie informacji o Twoim koncie:
Z użyciem cURL
curl -X GET "https://api.brevo.com/v3/account" \ -H "Accept: application/json" \ -H "api-key: YOUR_API_KEY"Z użyciem JavaScript (Node.js)
const fetch = require('node-fetch');
const getAccount = async () => { try { const response = await fetch('https://api.brevo.com/v3/account', { method: 'GET', headers: { 'Accept': 'application/json', 'api-key': 'YOUR_API_KEY' } });
const data = await response.json(); console.log('Account Info:', data); } catch (error) { console.error('Error:', error); }};
getAccount();Z użyciem Pythona
import requests
url = "https://api.brevo.com/v3/account"headers = { "Accept": "application/json", "api-key": "YOUR_API_KEY"}
response = requests.get(url, headers=headers)print(response.json())Z użyciem PHP
<?php$url = 'https://api.brevo.com/v3/account';$headers = [ 'Accept: application/json', 'api-key: YOUR_API_KEY'];
$ch = curl_init();curl_setopt($ch, CURLOPT_URL, $url);curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);curl_close($ch);
echo $response;?>Oczekiwana odpowiedź
Jeśli wszystko się powiedzie, otrzymasz odpowiedź w takiej postaci:
{ "firstName": "John", "lastName": "Doe", "companyName": "Your Company", "address": { "street": "123 Main Street", "city": "New York", "zipCode": "10001", "country": "United States" }, "plan": [ { "type": "payAsYouGo", "credits": 10000, "creditsUsed": 1500 } ]}Obsługa błędów
Jeśli napotkasz błędy, sprawdź te najczęstsze przyczyny:
Nieprawidłowy klucz API (401 Unauthorized)
{ "code": "unauthorized", "message": "Invalid API key provided"}Rozwiązanie: sprawdź, czy Twój klucz API jest poprawny i ma odpowiednie uprawnienia.
Przekroczony limit zapytań (429 Too Many Requests)
{ "code": "too_many_requests", "message": "Rate limit exceeded"}Rozwiązanie: odczekaj przed wysłaniem kolejnego zapytania lub przejdź na wyższy plan.
Błąd serwera (500 Internal Server Error)
{ "code": "internal_error", "message": "An internal error occurred"}Rozwiązanie: sprawdź naszą stronę statusu lub skontaktuj się ze wsparciem.
Następne kroki
Teraz, gdy masz za sobą pierwsze udane wywołanie API:
- Skonfiguruj uwierzytelnianie jak należy
- Zainstaluj SDK dla swojego języka
- Poznaj limity zapytań
- Przejrzyj endpointy email