Wyślij do 50 wiadomości przez jedno połączenie SMTP przy użyciu danych…
Wyślij do 50 wiadomości przez jedno połączenie SMTP przy użyciu danych uwierzytelniających serwera podanych przez wywołującego credentialsessage actually sent)
Żądanie
- x-api-key: <your-api-key>
- Content-Type: application/json
Odpowiedź
{
"results": [],
"status": "success",
"tokensDeducted": 1
}Co robi
Wyślij do 50 wiadomości przez jedno połączenie SMTP przy użyciu danych uwierzytelniających serwera podanych przez wywołującego credentialsessage actually sent)
Żądanie
Treść
| Pole | Typ | Wymagane | Opis |
|---|---|---|---|
messages | array<object> | tak | |
↳ attachments | array<object> | nie | |
↳ bcc | array<string> | nie | |
↳ cc | array<string> | nie | |
↳ from | string | nie | |
↳ html | string | nie | |
↳ subject | string | tak | |
↳ text | string | nie | |
↳ to | array<string> | tak | |
server | object | tak | |
↳ host | string | tak | |
↳ password | string | tak | |
↳ port | integer | tak | |
↳ secure | boolean | tak | |
↳ username | string | tak |
Przykładowe żądanie
{
"messages": [
{
"attachments": [
{
"content": "Hello from castomAPI.",
"contentType": "application/pdf",
"filename": "report.pdf"
}
],
"bcc": [],
"cc": [],
"from": "ada@example.com",
"html": "<h1>Hello</h1><p>From castomAPI.</p>",
"subject": "Your September invoice",
"text": "Hello from castomAPI.",
"to": [
"grace@example.com"
]
}
],
"server": {
"host": "example.com",
"password": "correct-horse-battery-staple",
"port": 4,
"secure": true,
"username": "ada"
}
}Odpowiedź
| Pole | Typ | Opis |
|---|---|---|
results | array<object> | |
status | string | |
tokensDeducted | integer |
Przykładowa odpowiedź
{
"results": [],
"status": "success",
"tokensDeducted": 1
}Błędy
Każdy błąd ma tę samą kopertę: status HTTP, kod maszynowy i jedno zdanie.
400 | Treść albo parametr nie przeszły walidacji. Tablica details wskazuje pole. |
401 | Brak klucza, klucz cofnięty albo zły nagłówek. Wyślij x-api-key. |
402 | Portfel nie pokrywa tego wywołania. Doładuj albo poczekaj na miesięczny przydział. |
404 | Zasób nie istnieje albo nie jest Twój. Obie sytuacje odpowiadają identycznie i nic nie kosztują. |
429 | Przekroczony limit na minutę dla Twojego planu. Odczekaj i ponów. |
5xx | Usługa nadrzędna odmówiła albo przekroczyła czas. Wywołanie nie jest rozliczane. |
Kod
curl -X POST 'https://app.castomapi.com/v1/email/send' \
-H 'x-api-key: <your-api-key>' \
-H 'Content-Type: application/json' \
-d '{"messages": [{"attachments": [{"content": "Hello from castomAPI.", "contentType": "application/pdf", "filename": "report.pdf"}], "bcc": [], "cc": [], "from": "ada@example.com", "html": "<h1>Hello</h1><p>From castomAPI.</p>", "subject": "Your September invoice", "text": "Hello from castomAPI.", "to": ["grace@example.com"]}], "server": {"host": "example.com", "password": "correct-horse-battery-staple", "port": 4, "secure": true, "username": "ada"}}'const res = await fetch('https://app.castomapi.com/v1/email/send', {
method: 'POST',
headers: { 'x-api-key': '<your-api-key>', 'Content-Type': 'application/json' },
body: JSON.stringify({"messages": [{"attachments": [{"content": "Hello from castomAPI.", "contentType": "application/pdf", "filename": "report.pdf"}], "bcc": [], "cc": [], "from": "ada@example.com", "html": "<h1>Hello</h1><p>From castomAPI.</p>", "subject": "Your September invoice", "text": "Hello from castomAPI.", "to": ["grace@example.com"]}], "server": {"host": "example.com", "password": "correct-horse-battery-staple", "port": 4, "secure": true, "username": "ada"}})
});
const data = await res.json();
console.log(data);import { request } from 'node:https';
// Node 18+ has fetch built in
const res = await fetch('https://app.castomapi.com/v1/email/send', {
method: 'POST',
headers: { 'x-api-key': '<your-api-key>', 'Content-Type': 'application/json' },
body: JSON.stringify({"messages": [{"attachments": [{"content": "Hello from castomAPI.", "contentType": "application/pdf", "filename": "report.pdf"}], "bcc": [], "cc": [], "from": "ada@example.com", "html": "<h1>Hello</h1><p>From castomAPI.</p>", "subject": "Your September invoice", "text": "Hello from castomAPI.", "to": ["grace@example.com"]}], "server": {"host": "example.com", "password": "correct-horse-battery-staple", "port": 4, "secure": true, "username": "ada"}})
});
const data = await res.json();
console.log(data);import requests
res = requests.post(
'https://app.castomapi.com/v1/email/send',
headers={'x-api-key': '<your-api-key>'},
json={"messages": [{"attachments": [{"content": "Hello from castomAPI.", "contentType": "application/pdf", "filename": "report.pdf"}], "bcc": [], "cc": [], "from": "ada@example.com", "html": "<h1>Hello</h1><p>From castomAPI.</p>", "subject": "Your September invoice", "text": "Hello from castomAPI.", "to": ["grace@example.com"]}], "server": {"host": "example.com", "password": "correct-horse-battery-staple", "port": 4, "secure": True, "username": "ada"}},
timeout=30,
)
print(res.json())<?php
$ch = curl_init('https://app.castomapi.com/v1/email/send');
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['x-api-key: <your-api-key>', 'Content-Type: application/json'],
CURLOPT_POSTFIELDS => json_encode(['messages' => [['attachments' => [['content' => 'Hello from castomAPI.', 'contentType' => 'application/pdf', 'filename' => 'report.pdf']], 'bcc' => [], 'cc' => [], 'from' => 'ada@example.com', 'html' => '<h1>Hello</h1><p>From castomAPI.</p>', 'subject' => 'Your September invoice', 'text' => 'Hello from castomAPI.', 'to' => ['grace@example.com']]], 'server' => ['host' => 'example.com', 'password' => 'correct-horse-battery-staple', 'port' => 4, 'secure' => true, 'username' => 'ada']]),
]);
$data = json_decode(curl_exec($ch), true);
print_r($data);Koszt i limity
Ta operacja kosztuje od 1 token. Nieudane wywołanie nigdy nie jest rozliczane. Każde konto dostaje 1000 darmowych tokenów miesięcznie; opłacone saldo nie wygasa. 1 token za każdą faktycznie wysłaną wiadomość.
Limity żądań na minutę
| Bez klucza | 10 |
| Free | 60 |
| Pro | 300 |
| Enterprise | 1200 |
Pytania
Ile kosztuje Wyślij do 50 wiadomości przez jedno połączenie SMTP przy użyciu danych…?
od 1 token za udane wywołanie, pobierane z portfela po odpowiedzi. Nieudane wywołania są bezpłatne. Każde konto dostaje 1000 darmowych tokenów miesięcznie. 1 token za każdą faktycznie wysłaną wiadomość.
Jak się uwierzytelnić?
Wyślij klucz w nagłówku x-api-key. Jeden klucz obejmuje każdy rozliczany endpoint; niczego nie trzeba włączać osobno.
Czy mogę wysłać nagłówek Authorization: Bearer zamiast klucza?
Nie dla rozliczanego endpointu — te przyjmują wyłącznie nagłówek x-api-key. Tokeny Bearer należą do strony konta: panel i API konta przyjmują sesję JWT, a castomapi-auth wydaje je standardowym uzgodnieniem OAuth2, z grantami authorization code, client credentials i refresh. Opisuje to strona usługi auth.
Jakie są limity?
10 żądań na minutę z jednego IP zupełnie bez klucza, 60 na minutę w planie Free, 300 w Pro, 1200 w Enterprise. Powyżej poziomu bez klucza limit jest na konto, łącznie dla wszystkich endpointów.
OpenAPI: https://app.castomapi.com/docs/json