SDK Overview

npm install mailbreeze

pip install mailbreeze

implementation("com.mailbreeze:mailbreeze-java:0.1.0")

go get github.com/MailBreeze/mailbreeze-go

composer require mailbreeze/mailbreeze-php

cargo add mailbreeze

import { MailBreeze } from "mailbreeze";

const mailbreeze = new MailBreeze({
  apiKey: process.env.MAILBREEZE_API_KEY,
  // Optional configuration
  baseUrl: "https://api.mailbreeze.com", // Custom API URL
  timeout: 30000, // Request timeout in ms
});

from mailbreeze import MailBreeze

client = MailBreeze(
    api_key=os.environ["MAILBREEZE_API_KEY"],
    # Optional configuration
    base_url="https://api.mailbreeze.com",
    timeout=30.0,
)

import com.mailbreeze.MailBreeze;

MailBreeze mailbreeze = MailBreeze.builder()
    .apiKey(System.getenv("MAILBREEZE_API_KEY"))
    // Optional configuration
    .baseUrl("https://api.mailbreeze.com")
    .timeout(Duration.ofSeconds(30))
    .build();

import mailbreeze "github.com/MailBreeze/mailbreeze-go"

client := mailbreeze.NewClient(
    os.Getenv("MAILBREEZE_API_KEY"),
    // Optional configuration
    mailbreeze.WithBaseURL("https://api.mailbreeze.com"),
    mailbreeze.WithTimeout(30 * time.Second),
)

use MailBreeze\MailBreeze;

$mailbreeze = new MailBreeze(
    getenv('MAILBREEZE_API_KEY'),
    // Optional configuration
    [
        'base_url' => 'https://api.mailbreeze.com',
        'timeout' => 30,
    ]
);

use mailbreeze::MailBreeze;

let client = MailBreeze::builder("sk_live_xxx")
    // Optional configuration
    .base_url("https://api.mailbreeze.com")
    .timeout(Duration::from_secs(30))
    .build()?;

import { MailBreeze, MailBreezeError } from "mailbreeze";

try {
  await mailbreeze.emails.send({ ... });
} catch (error) {
  if (error instanceof MailBreezeError) {
    console.log(error.code);    // "VALIDATION_ERROR"
    console.log(error.message); // "Invalid email format"
    console.log(error.status);  // 400
  }
}

from mailbreeze import MailBreeze, MailBreezeError

try:
    await client.emails.send(...)
except MailBreezeError as e:
    print(e.code)     # "VALIDATION_ERROR"
    print(e.message)  # "Invalid email format"
    print(e.status)   # 400

import com.mailbreeze.exceptions.*;

try {
    mailbreeze.emails().send(params);
} catch (MailBreezeException e) {
    System.out.println(e.getCode());       // "VALIDATION_ERROR"
    System.out.println(e.getMessage());    // "Invalid email format"
    System.out.println(e.getStatusCode()); // 400
}

import "errors"

_, err := client.Emails.Send(ctx, params)
if err != nil {
    var mbErr *mailbreeze.Error
    if errors.As(err, &mbErr) {
        fmt.Println(mbErr.Code)    // "VALIDATION_ERROR"
        fmt.Println(mbErr.Message) // "Invalid email format"
        fmt.Println(mbErr.Status)  // 400
    }
}

use MailBreeze\Exceptions\MailBreezeException;

try {
    $mailbreeze->emails()->send([...]);
} catch (MailBreezeException $e) {
    echo $e->getCode();    // "VALIDATION_ERROR"
    echo $e->getMessage(); // "Invalid email format"
    echo $e->getStatus();  // 400
}

match client.emails.send(&params).await {
    Ok(email) => println!("Sent: {}", email.id),
    Err(mailbreeze::Error::Api { code, message, status }) => {
        println!("Code: {}", code);    // "VALIDATION_ERROR"
        println!("Message: {}", message); // "Invalid email format"
        println!("Status: {}", status);   // 400
    }
    Err(e) => println!("Other error: {}", e),
}