MAILBRIDGEAPI / DOKÜMANTASYON

E-posta API belgeleri: SMTP ve IMAP.

Kendi SMTP ve IMAP posta kutunuzu hesap ve posta kutusu API anahtarlarına bağlayın. Seçilen kutuyu göndermek, okumak ve yönetmek için HTTP isteklerinde ikisini de kullanın.

Temel URLhttps://api.mailbridgeapi.com

API ve ürün değişikliklerini takip edin.

Bir entegrasyonu değiştirmeden önce yayınlanan endpoint, dokümantasyon ve platform güncellemelerini inceleyin.

Değişiklik günlüğünü aç

Bir yapay zeka asistanıyla mı inşaat yapıyorsunuz?

Asistanınıza kaynak destekli MailBridgeAPI belge sunmak için aranabilir bilgi tabanımızı, tam metin referansımızı ve salt okunur API'mizi kullanın.

Bilgi tabanını keşfedin

Üç adımda ilk isteğiniz

Gelen kutunuzu okuyarak başlayın. Başarılı bir yanıt gördüğünüzde mesaj göndermeyi deneyebilirsiniz.

Anahtarlarınızı bağlayın

Hesap API anahtarınızı ve yapılandırılmış bir posta kutusunun anahtarını yapıştırın. Bağlan'a tıklayın.

Gelen kutunuzu alın

“E-postaları al”ı açın, INBOX'yi koruyun ve 0 ile başlayın, ardından E-postaları al'a tıklayın.

Sonucu okuyun

HTTP 200, sunucunun yanıt verdiği anlamına gelir. result.error = "0" başarıyı gösterir; e-postalar result.emaillist içindedir.

BAĞLANTIYI GÖRÜN

Tek bir posta kutusu tüm projeleriniz için API'ye dönüşür.

MailBridgeAPI, SMTP ve IMAP posta kutunuzu iki API anahtarına güvenle bağlar. Uygulamalarınız posta kutusu parolasını kullanmadan e-posta göndermek ve gelen iletileri işlemek için açık endpointleri çağırır.

01Posta kutunuzyou@company.comAdresiniz ve sağlayıcınız

MailBridgeAPI

Posta kutusu API anahtarımbox_••••7F3A

Bağlı ve hazır

03Kullanılabilir endpointler

POST /sendemail/

GET /getemail/

GET /email/unsubscribed/

04Projeleriniz

Web sitesiCRMOtomasyon

Projeniz API anahtarlarını sunucuda saklar. Posta kutusu parolası MailBridgeAPI yapılandırmasında kalır.

İNTERAKTİF API GEZGİSİ Bağlı değil

API'yi posta kutunuzla deneyin

Hesap anahtarınızı bağlayın, bir posta kutusu seçin ve aşağıdan bir istek çalıştırın. Bu istekler canlı MailBridgeAPI hizmetini kullanır.

Anahtarlar bu sayfanın belleğinde kalır ve bağlantı kesildiğinde veya yeniden yüklendiğinde silinir. İstekler bu web sitesinin sunucusu üzerinden MailBridgeAPI adresine iletilir.

GÖNDERME VE ALMADAN DAHA FAZLASI

Posta kutunuzu yönetmek için profesyonel endpointler.

Yapılandırmayı ve etkinliği kontrol edin, mesaj bulun, rapor oluşturun ve SMTP öncesinde gönderimi doğrulayın. Tüm endpointler aynı anahtarları kullanır.

Yeni entegrasyonlarda header kullanın

Hesap anahtarını X-API-Key, posta kutusu anahtarını X-Mailbox-Key ile gönderin. apikey ve apikeybox uyumluluk için kullanılabilir. İkisini de sunucuda saklayın.

X-API-KeyX-Mailbox-Key

GET/mailbox/status/

Posta kutusu durumu

Kimlik bilgilerini göstermeden SMTP, IMAP ve özellikleri denetleyin.

Kurulum, izleme ve destek için.

Yararlı parametrelerEk parametre yok.

İstek örneği+

<?php
$params = [

];
$query = http_build_query($params);
$url = 'https://api.mailbridgeapi.com/mailbox/status/' . ($query === '' ? '' : '?' . $query);

$headers = [
    'X-API-Key: ' . getenv('MAILBRIDGE_API_KEY'),
    'X-Mailbox-Key: ' . getenv('MAILBRIDGE_BOX_KEY'),
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Bağlı anahtarlarla test edinLIVE

JSON yanıtı

Yanıtı görmek için endpointi çalıştırın.

GET/email/sent/

Gönderilen e-postalar

Durum, alıcı, tarih ve kaynak filtreli sayfalı geçmiş.

Teslimat panoları ve SMTP hataları için.

Yararlı parametreler

pageper_pagestatusrecipientfromtosourceinclude_body

İstek örneği+

<?php
$params = [
    'page' => '1',
    'per_page' => '5',
    'status' => 'all',
];
$query = http_build_query($params);
$url = 'https://api.mailbridgeapi.com/email/sent/' . ($query === '' ? '' : '?' . $query);

$headers = [
    'X-API-Key: ' . getenv('MAILBRIDGE_API_KEY'),
    'X-Mailbox-Key: ' . getenv('MAILBRIDGE_BOX_KEY'),
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Bağlı anahtarlarla test edinLIVE

JSON yanıtı

Yanıtı görmek için endpointi çalıştırın.

GET/email/received/

Alınan e-postalar

Kayıtlı mesajları sayfalama ve filtrelerle okuyun.

Destek, CRM ve işlem kuyrukları için.

Yararlı parametreler

pageper_pagesenderfromtoinclude_body

İstek örneği+

<?php
$params = [
    'page' => '1',
    'per_page' => '5',
];
$query = http_build_query($params);
$url = 'https://api.mailbridgeapi.com/email/received/' . ($query === '' ? '' : '?' . $query);

$headers = [
    'X-API-Key: ' . getenv('MAILBRIDGE_API_KEY'),
    'X-Mailbox-Key: ' . getenv('MAILBRIDGE_BOX_KEY'),
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Bağlı anahtarlarla test edinLIVE

JSON yanıtı

Yanıtı görmek için endpointi çalıştırın.

GET/email/message/

Mesaj ayrıntısı

MailBridgeAPI kimliğiyle bir gönderilen veya alınan mesajı getirin.

Tam içeriği yalnızca gerektiğinde yükleyin.

Yararlı parametreler

directionid

İstek örneği+

<?php
$params = [
    'direction' => 'sent',
    'id' => '',
];
$query = http_build_query($params);
$url = 'https://api.mailbridgeapi.com/email/message/' . ($query === '' ? '' : '?' . $query);

$headers = [
    'X-API-Key: ' . getenv('MAILBRIDGE_API_KEY'),
    'X-Mailbox-Key: ' . getenv('MAILBRIDGE_BOX_KEY'),
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Bağlı anahtarlarla test edinLIVE

JSON yanıtı

Yanıtı görmek için endpointi çalıştırın.

GET/email/activity/

Posta kutusu etkinliği

1–90 gün için toplamları ve günlük seriyi alın.

Grafikler ve raporlar için.

Yararlı parametreler

days

İstek örneği+

<?php
$params = [
    'days' => '30',
];
$query = http_build_query($params);
$url = 'https://api.mailbridgeapi.com/email/activity/' . ($query === '' ? '' : '?' . $query);

$headers = [
    'X-API-Key: ' . getenv('MAILBRIDGE_API_KEY'),
    'X-Mailbox-Key: ' . getenv('MAILBRIDGE_BOX_KEY'),
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Bağlı anahtarlarla test edinLIVE

JSON yanıtı

Yanıtı görmek için endpointi çalıştırın.

POST/email/validate/

Gönderim öncesi doğrulama

Alıcıyı, konuyu, gövdeyi, biçimi ve SMTP’yi göndermeden doğrulayın.

/sendemail/ öncesi hataları yakalayın.

Yararlı parametreler

recipient_emailmail_subjectmail_bodyformat

İstek örneği+

<?php
$payload = [
    'recipient_email' => 'developer@example.com',
    'mail_subject' => 'Preflight validation',
    'mail_body' => 'This payload is validated without sending an email.',
    'format' => 'text',
];

$headers = [
    'X-API-Key: ' . getenv('MAILBRIDGE_API_KEY'),
    'X-Mailbox-Key: ' . getenv('MAILBRIDGE_BOX_KEY'),
];
$headers[] = 'Content-Type: application/json';

$ch = curl_init('https://api.mailbridgeapi.com/email/validate/');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_THROW_ON_ERROR),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Bağlı anahtarlarla test edinLIVE

JSON yanıtı

Yanıtı görmek için endpointi çalıştırın.

GET/mailbox/insights/

Posta kutusu analizleri

Teslimat güvenilirliği, gelen hacim, son etkinlik ve son hatayı tek görünümde alın.

Durum sayfaları, uyarılar ve operasyon ekranları için.

Yararlı parametreler

days

İstek örneği+

<?php
$params = [
    'days' => '30',
];
$query = http_build_query($params);
$url = 'https://api.mailbridgeapi.com/mailbox/insights/' . ($query === '' ? '' : '?' . $query);

$headers = [
    'X-API-Key: ' . getenv('MAILBRIDGE_API_KEY'),
    'X-Mailbox-Key: ' . getenv('MAILBRIDGE_BOX_KEY'),
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Bağlı anahtarlarla test edinLIVE

JSON yanıtı

Yanıtı görmek için endpointi çalıştırın.

GET/email/search/

Birleşik e-posta araması

İçeriği yüklemeden kimlik, konu veya adrese göre gelen ve giden iletileri arayın.

Her iki yöndeki konuşmaları hızla bulun.

Yararlı parametreler

querydirectionpageper_pagefromto

İstek örneği+

<?php
$params = [
    'query' => 'invoice',
    'direction' => 'all',
    'page' => '1',
    'per_page' => '10',
];
$query = http_build_query($params);
$url = 'https://api.mailbridgeapi.com/email/search/' . ($query === '' ? '' : '?' . $query);

$headers = [
    'X-API-Key: ' . getenv('MAILBRIDGE_API_KEY'),
    'X-Mailbox-Key: ' . getenv('MAILBRIDGE_BOX_KEY'),
];

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Bağlı anahtarlarla test edinLIVE

JSON yanıtı

Yanıtı görmek için endpointi çalıştırın.

OpenAPI 3.1 tanımını indirSözleşmeyi Postman, Insomnia, Swagger UI veya kod üreticinize aktarın.

Ne yapmak istediğinizi seçin

E-postaları alın

Bir IMAP klasöründen en fazla 30 e-postayı okuyun.

GET

E-posta gönder

Bağlı posta kutunuzdan bir e-posta gönderin.

POST

Kayıtların aboneliğini iptal et

Kişi listenizi güncellemek için vazgeçme kayıtlarını okuyun.

GET

İki anahtar. İki farklı iş.

Her istekte her iki değeri de kullanın. API isteklerinde e-posta şifreniz kullanılmaz.

apikey

Hesap API anahtarı

Hesabınızı tanımlar. MailBridgeAPI kontrol panelinizde bulun.

apikeybox

Posta Kutusu API anahtarı

Gönderilecek veya okunacak posta kutusunu seçer. Bu, kontrol panelinizdeki apikeybox değeridir.

İstekler iki değer gerektirir: apikey hesabınızı tanımlar; apikeybox yapılandırılmış bir posta kutusunu seçer. Örnekler belgelenmiş istek parametrelerini kullanır. Anahtarları sunucu tarafı ortam değişkenlerinde tutun.

Kimlik doğrulama — İsteğe bağlı

GET uç noktaları için sorgu parametreleri günlüklerde görünebilir. Yayınlanan referans aynı zamanda hesap anahtarı için Bearer kimlik doğrulamasını da açıklamaktadır; Benimsemeden önce entegrasyonunuzdaki desteği doğrulayın.

GET/getemail/

E-postaları alın

Seçilen bir IMAP klasöründeki mesajları okuyun. Sonuç, result.emaillist altında UID anahtarlı bir harita içerir. Her sayfada en fazla 30 mesaj bulunur; sonraki sayfayı almak için başlangıcı 30 artırın.

Bu uç noktayı deneyinLIVE

Bu uç noktayı denemek için yukarıdaki hesap API anahtarınızı bağlayın.

API bağlantısına git

Önizleme iste

{
  "method": "GET",
  "url": "https://api.mailbridgeapi.com/getemail/",
  "parameters": {
    "apikey": "YOUR_CONNECTED_API_KEY",
    "apikeybox": "YOUR_SELECTED_MAILBOX_KEY",
    "mbox": "INBOX",
    "start": "0"
  }
}

Canlı yanıt

İsteği çalıştırdıktan sonra yanıtınız burada görünecek.

Bu parametrelerle başlayın

Parametre	Gerekli	Açıklama
`apikey`	Gerekli	Hesap API anahtarı.
`apikeybox`	Gerekli	Bağlı IMAP posta kutusunun API anahtarı.
`mbox`	Gerekli	INBOX, Gönderilmiş veya Taslaklar gibi IMAP klasörü adı.

Tüm isteğe bağlı parametreler+

Bunları yalnızca ilgili özelliğe ihtiyacınız olduğunda ekleyin.

Parametre	Gerekli	Açıklama
`start`	İsteğe bağlı	Sıfır tabanlı endeks; varsayılan değer 0'dır. Sayfa başına en fazla 30 mesaj.

Örnek isteyin

<?php
$query = http_build_query([
    'apikey' => getenv('MAILBRIDGE_API_KEY'),
    'apikeybox' => getenv('MAILBRIDGE_BOX_KEY'),
    'mbox' => 'INBOX',
    'start' => '0'
]);

$ch = curl_init('https://api.mailbridgeapi.com/getemail/?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Yalnızca örnek — canlı istek yok

Bu yanıt nasıl okunmalı?

Mesajlar, result.emaillist altında IMAP UID değerlerine göre gruplandırılır. Konu (nesne) ve gövde URL kodlu olabilir. Bu alanları metin olarak görüntülemeden önce kodunu çözün.

Boş bir e-posta listesi geçerli bir başarılı yanıt olabilir. Seçilen klasörü kontrol edin ve dizini başlatın.

Örnek yanıt+

{
  "result": {
    "error": "0",
    "emaillist": {
      "50123": {
        "id": 50123,
        "object": "Hello%20there",
        "body": "%3Cp%3EHello%3C%2Fp%3E",
        "email1": "jane@example.com",
        "email2": "hello@yourcompany.com",
        "timestamp": 1736505600,
        "date": "10/01/2025 - 09:20:00",
        "size": 42,
        "attachment": null,
        "loop": 0
      }
    }
  }
}

POST/sendemail/

E-posta gönder

Seçilen posta kutusunun SMTP bağlantısı üzerinden bir e-posta gönderin. HTML, metin, CC alıcılarını, ekleri, satır içi resimleri ve isteğe bağlı abonelikten çıkma altbilgisini destekler.

Gönderilmiş klasöründe isteğe bağlı arşivleme

Başarılı API gönderimlerini ayrı bir IMAP arka plan göreviyle arşivlemek için kontrol panelinde posta kutusu için gönderilmiş kopyaları etkinleştirin. SMTP gönderimi bağımsız kalır: bir IMAP sorunu kabul edilmiş gönderimi API hatasına dönüştürmez. Asla arşivlenmemesi gereken isteklere skip_sent_copy=1 ekleyin.

Bu uç noktayı deneyinLIVE

Bu uç noktayı denemek için yukarıdaki hesap API anahtarınızı bağlayın.

API bağlantısına git

Alıcı e-postası *Konu *Mesaj *Mesaj formatı

İsteğe bağlı parametreler+

Gönderenin e-postasıGönderenin adıE-postayı yanıtlaYanıt adıCC alıcısı 1CC alıcısı 2CC alıcısı 3Karakter setiEk 1 dosya adıEk 1 (base64)Ek 2 dosya adıEk 2 (base64)Satır içi resim URL'siSatır içi resim İçerik KimliğiKaynak etiketi

Abonelikten çıkma altbilgisini ekleyinKendinden imzalı TLS sertifikalarına izin verNormal sertifika doğrulaması için devre dışı bırakın.Gezgin istek başına 1 MB'a kadar kabul eder. Test eklerini küçük tutun.

Bunun, yukarıda girilen alıcıya gerçek bir e-posta gönderdiğini anlıyorum.

Bu bir simülasyon değil, canlı bir gönderimdir. Sağlayıcınızın gönderme sınırları geçerlidir.

Önizleme iste

{
  "method": "POST",
  "url": "https://api.mailbridgeapi.com/sendemail/",
  "parameters": {
    "apikey": "YOUR_CONNECTED_API_KEY",
    "apikeybox": "YOUR_SELECTED_MAILBOX_KEY",
    "mail_subject": "MailBridgeAPI'den merhaba",
    "mail_body": "Bu, bağlı posta kutumdan gönderilen bir test e-postasıdır.",
    "format": "text"
  }
}

Canlı yanıt

İsteği çalıştırdıktan sonra yanıtınız burada görünecek.

Bu parametrelerle başlayın

Parametre	Gerekli	Açıklama
`apikey`	Gerekli	Hesap API anahtarı.
`apikeybox`	Gerekli	Kullanılacak SMTP posta kutusunun API anahtarı.
`recipient_email`	Gerekli	Birincil alıcı e-posta adresi.
`mail_subject`	Gerekli	E-posta konusu.
`mail_body`	Gerekli	HTML veya düz metin mesaj gövdesi.

Tüm isteğe bağlı parametreler+

Bunları yalnızca ilgili özelliğe ihtiyacınız olduğunda ekleyin.

Parametre	Gerekli	Açıklama
`sender_email`	İsteğe bağlı	Gönderenin adresini geçersiz kılın; varsayılan olarak SMTP posta kutusu göndericisidir. Sağlayıcınız adrese izin vermelidir.
`sender_name`	İsteğe bağlı	Gönderenin görünen adını geçersiz kılın.
`reply_email`	İsteğe bağlı	Yanıt adresi; varsayılan olarak sender_email'dir.
`reply_name`	İsteğe bağlı	Yanıtla görünen adı.
`email_cc1, email_cc2, email_cc3`	İsteğe bağlı	En fazla üç CC alıcısı.
`format`	İsteğe bağlı	html (varsayılan) veya metin.
`charset`	İsteğe bağlı	Mesaj karakter seti; varsayılan olarak UTF-8'dir.
`attachmentBase64_1, attachmentBase64_2`	İsteğe bağlı	Ek içerikleri base64 olarak kodlanmıştır.
`attachmentBase64_name_1, attachmentBase64_name_2`	İsteğe bağlı	İlgili eklerin dosya adları.
`embeddedImage`	İsteğe bağlı	Satır içine yerleştirilecek genel resim URL'si.
`embeddedImage_cid`	İsteğe bağlı	HTML'de cid:YOUR_CID kullanılarak başvurulan İçerik Kimliği.
`unsubscribe`	İsteğe bağlı	Yapılandırılmış abonelikten çıkma altbilgisini eklemek için 1'e ayarlayın; varsayılan 0.
`from_source`	İsteğe bağlı	Gönderiminiz için isteğe bağlı bir kaynak etiketi.
`skip_sent_copy`	İsteğe bağlı	Arşivleme etkin olsa bile bu iletinin yapılandırılmış IMAP Gönderilmiş klasörüne kopyalanmasını engellemek için 1 olarak ayarlayın.
`allow_self_signed`	İsteğe bağlı	Kendinden imzalı TLS sertifikalarına izin vermek için evet olarak ayarlayın. Normal sertifika doğrulaması için atlayın.

Örnek isteyin

<?php
$payload = [
    'apikey' => getenv('MAILBRIDGE_API_KEY'),
    'apikeybox' => getenv('MAILBRIDGE_BOX_KEY'),
    'recipient_email' => 'jane@example.com',
    'mail_subject' => 'Hello, possibilities.',
    'mail_body' => 'Your next idea starts here.',
    'format' => 'text',
];

$ch = curl_init('https://api.mailbridgeapi.com/sendemail/');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($payload),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
// Check $data['result']['error'], not only the HTTP status.
print_r($data);

Yalnızca örnek — canlı istek yok

Bu yanıt nasıl okunmalı?

result.error = "0" ve result.sent = "Tamam" seçeneğini işaretleyin. SMTP sunucusu gönderimi kabul etti; bu, alıcının gelen kutusuna teslimatı garanti etmez.

Örnek yanıt+

{
  "result": {
    "error": "0",
    "sent": "OK",
    "id": "msg_example"
  }
}

GET/email/unsubscribed/

Kayıtların aboneliğini iptal et

result.customer altındaki bir posta kutusu için abonelikten çıkmayla ilgili en fazla 500 gönderme kaydını alın. İsteğe bağlı olarak alıcı e-postasına göre filtreleyin. Başlat parametresi ayrılmıştır ve göz ardı edilebilir.

Bu uç noktayı deneyinLIVE

Bu uç noktayı denemek için yukarıdaki hesap API anahtarınızı bağlayın.

API bağlantısına git

Önizleme iste

{
  "method": "GET",
  "url": "https://api.mailbridgeapi.com/email/unsubscribed/",
  "parameters": {
    "apikey": "YOUR_CONNECTED_API_KEY",
    "apikeybox": "YOUR_SELECTED_MAILBOX_KEY"
  }
}

Canlı yanıt

İsteği çalıştırdıktan sonra yanıtınız burada görünecek.

Bu parametrelerle başlayın

Parametre	Gerekli	Açıklama
`apikey`	Gerekli	Hesap API anahtarı.
`apikeybox`	Gerekli	SMTP posta kutusunun API anahtarı.

Tüm isteğe bağlı parametreler+

Bunları yalnızca ilgili özelliğe ihtiyacınız olduğunda ekleyin.

Parametre	Gerekli	Açıklama
`email`	İsteğe bağlı	Kayıtları alıcı e-posta adresine göre filtreleyin.
`start`	İsteğe bağlı	Ayrılmış dizin; mevcut uygulama tarafından göz ardı edilebilir.

Örnek isteyin

<?php
$query = http_build_query([
    'apikey' => getenv('MAILBRIDGE_API_KEY'),
    'apikeybox' => getenv('MAILBRIDGE_BOX_KEY'),
    'email' => 'jane@example.com'
]);

$ch = curl_init('https://api.mailbridgeapi.com/email/unsubscribed/?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
if ($response === false) {
    $message = curl_error($ch);
    curl_close($ch);
    throw new RuntimeException($message);
}
curl_close($ch);

$data = json_decode($response, true, 512, JSON_THROW_ON_ERROR);
print_r($data);

Yalnızca örnek — canlı istek yok

Bu yanıt nasıl okunmalı?

Kayıtlar result.customer'nin altında. Listenizi güncellemek için alıcıE-postasını kullanın. Bu uç nokta, devre dışı bırakma kayıtlarını okur; bir kişinin aboneliğini kendisi iptal etmez.

Örnek yanıt+

{
  "result": {
    "error": "0",
    "customer": [
      {
        "recipientEmail": "jane@example.com",
        "subject": "Monthly update",
        "unsubscribeaskedDate": "2025-01-11"
      }
    ]
  }
}

Yanıtlar ve hatalar

`200`	İstek işlendi. Sağlayıcı sonucu için result.error'i inceleyin.
`400`	Gerekli parametreler eksik.
`401`	Geçersiz veya süresi dolmuş API anahtarı ya da devre dışı bırakılmış bir hesap.
`500`	SMTP / IMAP sağlayıcı hatası veya dahili bir hata.

Bir şeyler ters giderse

401 / geçersiz anahtar+

Her iki anahtarı, seçilen posta kutusunu ve hesabın etkin durumunu kontrol edin.

SMTP bağlantı hatası+

Kontrol panelinde SMTP ana bilgisayarını, bağlantı noktasını, kimlik doğrulamasını ve gönderen izinlerini kontrol edin.

IMAP bağlantı hatası+

IMAP erişimini, kimlik bilgilerini ve tam klasör adını kontrol edin.

Hiçbir mesaj geri dönmedi+

INBOX'yi start = 0 ile deneyin. Klasör boş olabilir.

Gönderdikten sonra zaman aşımı+

Yeniden denemeden önce kontrol panelinizi veya Gönderilenler klasörünüzü kontrol edin. Gönderme zaten gerçekleşmiş olabilir.

Oran sınırları

Yayınlanan sınırlar: gönderme ve abonelikten çıkma alma — 120 istek/dakika; IMAP alımı — 60 istek/dakika. Sağlayıcınızın kendi sınırları da geçerlidir. Hatalarla başa çıkın ve yinelenen e-postalar oluşturabilecek gönderimleri körü körüne yeniden denemekten kaçının.

Kod örnekleri örnektir. Canlı istekler yalnızca açıkça bir uç nokta testi gönderdiğinizde çalışır.

E-posta API belgeleri: SMTP ve IMAP.

API ve ürün değişikliklerini takip edin.

Bir yapay zeka asistanıyla mı inşaat yapıyorsunuz?

Üç adımda ilk isteğiniz

Anahtarlarınızı bağlayın

Gelen kutunuzu alın

Sonucu okuyun

Tek bir posta kutusu tüm projeleriniz için API'ye dönüşür.

API'yi posta kutunuzla deneyin

Posta kutunuzu yönetmek için profesyonel endpointler.

Yeni entegrasyonlarda header kullanın

Posta kutusu durumu

Gönderilen e-postalar

Alınan e-postalar

Mesaj ayrıntısı

Posta kutusu etkinliği

Gönderim öncesi doğrulama

Posta kutusu analizleri

Birleşik e-posta araması

Ne yapmak istediğinizi seçin

İki anahtar. İki farklı iş.

Hesap API anahtarı

Posta Kutusu API anahtarı

E-postaları alın

Bu parametrelerle başlayın

Örnek isteyin

Bu yanıt nasıl okunmalı?

E-posta gönder

Gönderilmiş klasöründe isteğe bağlı arşivleme

Bu parametrelerle başlayın

Örnek isteyin

Bu yanıt nasıl okunmalı?

Kayıtların aboneliğini iptal et

Bu parametrelerle başlayın

Örnek isteyin

Bu yanıt nasıl okunmalı?

Yanıtlar ve hatalar

Bir şeyler ters giderse

Oran sınırları

Kendi posta kutunuzu API anahtarlarına bağlayın ve endpointlerle yönetin.

Kendi kutunuzdan gönderin

Posta kutunuzu okuyun

Posta kutusu verisini kullanın