从这里开始
Your first request in four steps
Configure a mailbox in the dashboard.
Copy both apikey and the mailbox apikeybox.
Send a simple text email first.
Add attachments or embedded images only after the basic request works.
验证
Keep credentials on your server
Email endpoints require the account apikey and the mailbox-specific apikeybox. Store both credentials server-side and mask them in application logs.
邮政
Send an email
https://api.smsmobileapi.com/sendemail/Sends plain-text or HTML email through a configured mailbox.
Use it for transactional or operational email from your application.
参数
| 姓名 | 类型 | Requirement | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | Your account API key. |
apikeybox |
细绳 | 必需的 | API key of the configured mailbox. |
sender_name |
细绳 | 必需的 | Display name of the sender. |
sender_email |
电子邮件 | 必需的 | Sender email address. |
recipient_email |
电子邮件 | 必需的 | Recipient address. |
mail_subject |
细绳 | 必需的 | Email subject. |
mail_body |
细绳 | 必需的 | Plain text or HTML body. |
allow_self_signed |
yes | no | 必需的 | Set to yes only when the configured mail server uses a trusted internal self-signed certificate. |
unsubscribe |
1 | 选修的 | Adds unsubscribe terms and a link. |
email_cc1 |
电子邮件 | 选修的 | First optional CC recipient. |
email_cc2 |
电子邮件 | 选修的 | Second optional CC recipient. |
email_cc3 |
电子邮件 | 选修的 | Third optional CC recipient. |
attachmentBase64 |
base64 | 选修的 | Base64 编码的附件内容。 |
charset |
细绳 | 选修的 | Character set; default UTF-8. |
embeddedImage |
HTTPS URL | 选修的 | Image to embed in the email. |
embeddedImage_cid |
细绳 | 选修的 | Content-ID referenced from the HTML body. |
format |
细绳 | 选修的 | Requested response format. |
reply_name |
细绳 | 选修的 | Reply-to display name. |
reply_email |
电子邮件 | 选修的 | Reply-to address. |
Request example
curl -X POST "https://api.smsmobileapi.com/sendemail/" \
-d "apikey=YOUR_API_KEY" \
-d "apikeybox=YOUR_MAILBOX_KEY" \
--data-urlencode "sender_name=Example Team" \
-d "sender_email=team@example.com" \
-d "recipient_email=customer@example.net" \
--data-urlencode "mail_subject=Order confirmation" \
--data-urlencode "mail_body=Your order has been confirmed." \
-d "allow_self_signed=no"Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.
Connect key ↑- Prefer POST because email bodies can be long.
- Base64 attachments can make requests large; apply sensible size limits in your application.
得到
Retrieve emails
https://api.smsmobileapi.com/getemail/Retrieves messages from a configured mailbox folder.
Use it to synchronize inbound email into a help desk or application workflow.
参数
| 姓名 | 类型 | Requirement | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | Your account API key. |
apikeybox |
细绳 | 必需的 | Mailbox API key. |
mbox |
细绳 | 必需的 | Mailbox folder, for example INBOX. |
start |
integer | 必需的 | Starting index; use 0 for the first page. |
Request example
curl "https://api.smsmobileapi.com/getemail/?apikey=YOUR_API_KEY&apikeybox=YOUR_MAILBOX_KEY&mbox=INBOX&start=0"Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.
Connect key ↑- Responses include available subject, sender, recipient, body, timestamp and attachment details.
得到
Check unsubscribed contacts
https://api.smsmobileapi.com/email/unsubscribed/Checks unsubscribe records generated by emails sent through the platform.
Use it before sending campaigns and when synchronizing suppression lists.
参数
| 姓名 | 类型 | Requirement | 描述 |
|---|---|---|---|
apikey |
细绳 | 必需的 | Your account API key. |
apikeybox |
细绳 | 必需的 | Mailbox API key. |
email |
电子邮件 | 选修的 | Filter one contact. An empty result means no unsubscribe record was found. |
Request example
curl "https://api.smsmobileapi.com/email/unsubscribed/?apikey=YOUR_API_KEY&apikeybox=YOUR_MAILBOX_KEY&email=customer@example.net"Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.
Connect key ↑- Keep your own recipient database synchronized with unsubscribe results.
- You remain responsible for applicable anti-spam and privacy rules.
故障排除
Errors and safe retries
Read the HTTP status and the JSON error field before retrying. Do not retry validation or authentication failures without correcting the request first.
| HTTP | 代码 | What to do |
|---|---|---|
| 400 | missing_parameter | A required parameter is empty or absent. Check the parameter table for the endpoint. |
| 403 | invalid_apikey | The API key is unknown, expired or not authorized for the requested feature. |
| 429 | too_many_requests | Requests are arriving too quickly. Wait, then retry with exponential backoff. |
| 500 | server_error | The service could not complete the request. Keep the response and contact support if it persists. |
需要帮助吗？
Bring the request context—not your secrets.
Share the endpoint, timestamp, HTTP status and sanitized response. Never include API keys, tokens or private message content.
