Đăng ký quyền truy cập sớm

Nhập tên của bạn cùng email hoặc số điện thoại. Chúng tôi sẽ liên hệ và gửi thông tin truy cập Tajo.

Trên trang này

Lệnh gọi API đầu tiên

Hãy thực hiện lệnh gọi API đầu tiên để xác minh rằng thiết lập Brevo API của bạn hoạt động đúng.

Điều kiện tiên quyết

Một tài khoản Brevo
Một API key lấy từ bảng điều khiển của bạn
Một công cụ để gửi yêu cầu HTTP (curl, Postman hoặc tương tự)

Lấy thông tin tài khoản

Lệnh gọi đầu tiên đơn giản nhất là lấy thông tin tài khoản của bạn:

Dùng cURL

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

Dùng 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();

Dùng Python

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())

Dùng 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;
?>

Phản hồi mong đợi

Nếu thành công, bạn sẽ nhận được phản hồi như sau:

{
  "email": "[email protected]",
  "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
    }
  ]
}

Xử lý lỗi

Nếu bạn gặp lỗi, hãy kiểm tra các vấn đề thường gặp sau:

API key không hợp lệ (401 Unauthorized, không được phép)

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

Giải pháp: Xác minh API key của bạn là chính xác và có đủ quyền phù hợp.

Vượt giới hạn tần suất (429 Too Many Requests, quá nhiều yêu cầu)

{
  "code": "too_many_requests",
  "message": "Rate limit exceeded"
}

Giải pháp: Hãy chờ trước khi gửi yêu cầu tiếp theo hoặc nâng cấp gói của bạn.

Lỗi máy chủ (500 Internal Server Error, lỗi nội bộ máy chủ)

{
  "code": "internal_error",
  "message": "An internal error occurred"
}

Giải pháp: Hãy kiểm tra trang trạng thái của chúng tôi hoặc liên hệ bộ phận hỗ trợ.

Bước tiếp theo

Giờ khi bạn đã thực hiện thành công lệnh gọi API đầu tiên: