APIs & tools
English
English En Tiếng Việt Vi

Sonjj API

Chào mừng đến với SonjjAPI — dịch vụ API mạnh mẽ cung cấp nhiều tiện ích khác nhau để nâng cao ứng dụng và đơn giản hóa quy trình làm việc của bạn.

Base URL: https://app.sonjj.com

Introduction

Chào mừng đến với SonjjAPI!

Dịch vụ API mạnh mẽ này cung cấp nhiều chức năng để nâng cao ứng dụng và đơn giản hóa quy trình làm việc của bạn:

  • Xác minh email — kiểm tra khả năng giao nhận và phát hiện địa chỉ disposable
  • Tạo email tạm thời — Gmail, Outlook và hộp thư tạm thời tổng hợp
  • Kiểm tra SEO — Moz, Ahrefs, phân tích backlink, trạng thái index Google
  • Tạo dữ liệu — hồ sơ người dùng, xác thực số điện thoại, chuyển HTML sang Markdown

SonjjAPI đều hỗ trợ tất cả.

Bắt Đầu

  1. Đăng ký tại my.sonjj.com để tạo tài khoản
  2. Lấy API key từ mục API trong dashboard của bạn
  3. Mua credits — xem Pricing
  4. Thực hiện request đầu tiên — thêm API key vào header X-Api-Key

Công Cụ & SDK

Bạn có thể dùng SonjjAPI với bất kỳ HTTP client nào:

  • cURL — kiểm tra nhanh từ command line
  • Python — requests hoặc httpx
  • JavaScript / Node.js — fetch hoặc axios
  • Postman / Insomnia — import trực tiếp schema OpenAPI

Hỗ Trợ

Authentication

Xác Thực

Tất cả các request API đều yêu cầu xác thực bằng API key được truyền trong header của request.

Lấy API Key

  1. Đăng nhập tại my.sonjj.com
  2. Vào mục API
  3. Sao chép X-Api-Key của bạn

Sử Dụng API Key

Thêm key vào header của mỗi request:

X-Api-Key: your_api_key_here

Ví Dụ Request

cURL

curl -X GET "https://app.sonjj.com/v1/check_email/validate?email=test@example.com" \
  -H "X-Api-Key: your_api_key_here"

Python

import requests

response = requests.get(
"https://app.sonjj.com/v1/check_email/validate",
params={"email": "test@example.com"},
headers={"X-Api-Key": "your_api_key_here"}
)
print(response.json())

JavaScript

const response = await fetch(
  "https://app.sonjj.com/v1/check_email/validate?email=test@example.com",
  { headers: { "X-Api-Key": "your_api_key_here" } }
);
const data = await response.json();

Lỗi Xác Thực

Status Ý nghĩa
401 API key bị thiếu hoặc không hợp lệ
403 API key hợp lệ nhưng bị từ chối (không đủ credits hoặc plan)
Rate Limits

Giới Hạn Tốc Độ

SonjjAPI áp dụng giới hạn tốc độ (rate limit) để đảm bảo sử dụng công bằng và ổn định dịch vụ cho tất cả người dùng.

Cách Hoạt Động

Rate limit được áp dụng theo từng API key và theo dõi ở hai cấp độ:

Cấp độ Giới hạn
Mỗi phút Phụ thuộc vào plan của bạn
Mỗi ngày Phụ thuộc vào plan của bạn

Khi vượt quá giới hạn, API trả về HTTP 429 kèm header Retry-After (giây cần chờ) và body:

{
  "error": {
"code": 429,
"message": "Rate limit exceeded. Please wait before retrying."
  }
}

Thực Hành Tốt Nhất

  • Cache response ở phía bạn khi có thể
  • Áp dụng exponential backoff khi nhận lỗi 429
  • Sử dụng bulk endpoint khi có thay vì gọi lặp lại nhiều lần
  • Theo dõi credits và lượng request tại my.sonjj.com
Error Codes

Mã Lỗi

SonjjAPI sử dụng HTTP status code chuẩn và trả lỗi theo định dạng JSON nhất quán.

Định Dạng Lỗi

{
  "error": {
"code": 400,
"message": "Mô tả lỗi dễ đọc"
  }
}

Bảng HTTP Status Code

Code Tên Mô tả
200 OK Request thành công
400 Bad Request Tham số không hợp lệ hoặc thiếu trường bắt buộc
401 Unauthorized Thiếu hoặc sai header X-Api-Key
402 Payment Required Không đủ credits để thực hiện request
403 Forbidden Từ chối truy cập — plan không bao gồm endpoint này
404 Not Found Tài nguyên yêu cầu không tồn tại
422 Unprocessable Entity JSON hợp lệ nhưng không vượt qua kiểm tra nghiệp vụ
429 Too Many Requests Vượt quá rate limit — chờ và thử lại
500 Internal Server Error Lỗi xảy ra ở phía server
503 Service Unavailable Server tạm thời quá tải hoặc đang bảo trì

Xử Lý Lỗi

Ví dụ Python

import requests

response = requests.get(
"https://app.sonjj.com/v1/check_email/validate",
params={"email": "test@example.com"},
headers={"X-Api-Key": "your_api_key_here"}
)

if response.status_code == 200:
data = response.json()
elif response.status_code == 429:
print("Rate limit — cần xử lý backoff")
elif response.status_code == 402:
print("Không đủ credits")
else:
error = response.json().get("error", {})
print(f"Lỗi {error.get('code')}: {error.get('message')}")
Email Tools

Kiểm tra sự tồn tại, trạng thái và tính disposable của email — bao gồm địa chỉ Gmail và Microsoft.

SEO Tools

Domain Authority (Moz), chỉ số Ahrefs, kiểm tra Google index và phân tích backlink phục vụ công việc SEO.

Validation Tools

Xác thực số điện thoại (libphonenumber) và tra cứu thông tin Bank Identification Number (BIN) của thẻ.

Network & Web

Tra cứu IP geolocation và công cụ chuyển đổi HTML sang Markdown.

Generators & Date

Sinh hồ sơ người dùng giả lập và chuyển đổi ngày dương sang ngày âm lịch (Can Chi, pha trăng).

Disposable Mail

Temporary Email API là dịch vụ API cho phép người dùng tạo và quản lý email tạm thời một cách dễ dàng và tự động.

Gmail Inbox

Temporary Gmail API là dịch vụ API cho phép người dùng sử dụng địa chỉ Gmail do hệ thống tạo ra để nhận tin nhắn OTP, đăng ký tài khoản, đăng ký bản tin và nhiều hơn nữa.

Outlook Inbox

Temporary Outlook API là dịch vụ API cho phép người dùng sử dụng địa chỉ Outlook do hệ thống tạo ra để nhận tin nhắn OTP, đăng ký tài khoản và nhiều hơn nữa.

Schemas

Address

PropertyTypeDescription
address1* string

Dòng địa chỉ chính.
address2 string

Dòng địa chỉ phụ.
city string

Thành phố của địa chỉ.
state string

Bang/Tỉnh của địa chỉ.
postalCode* string

Mã bưu chính của địa chỉ.
coordinates* object

Tọa độ

AhrefsDataSchema

PropertyTypeDescription
page* object

PageSchema
domain* object

DomainSchema

CheckBINOut

PropertyTypeDescription
type* string

Loại thẻ (CREDIT/DEBIT)
country* string

Quốc gia của nhà phát hành thẻ
brand* string

Thương hiệu của thẻ (ví dụ: VISA, MASTERCARD)
level* string

Cấp độ của thẻ (ví dụ: BUSINESS, CLASSIC)
bin* integer

Bank Identification Number (BIN)
bank* string

Tên ngân hàng đã phát hành thẻ

CheckIndexOut

PropertyTypeDescription
isIndex* boolean

True nếu trang được index, False nếu không
server* integer

Phản hồi của server

Coordinates

PropertyTypeDescription
lat* number

Vĩ độ của địa chỉ.
lng* number

Kinh độ của địa chỉ.

DateOfBirth

PropertyTypeDescription
day* integer

Ngày sinh.
month* integer

Tháng sinh.
year* integer

Năm sinh.

DisposableEmailResponse

Schema phản hồi cho kiểm tra domain email dùng một lần.

Trả về điểm rủi ro từ 0-100 cho biết khả năng domain được sử dụng cho các dịch vụ email dùng một lần/tạm thời.

PropertyTypeDescription
domain* string

Tên domain đã được kiểm tra tính dùng một lần
score* integer

Điểm rủi ro dùng một lần từ 0-100, trong đó điểm cao hơn cho thấy rủi ro cao hơn. Các mức độ rủi ro: 0 = Chắc chắn hợp pháp (Gmail, Outlook, Yahoo, các nhà cung cấp lớn), 1-30 = Rủi ro thấp (domain công ty, không rõ nhưng trông có vẻ hợp pháp), 31-60 = Rủi ro trung bình (mẫu đáng ngờ, TLDs đáng ngờ), 61-85 = Rủi ro cao (domain catch-all, khớp mẫu), 86-100 = Rủi ro rất cao (được biết là dùng một lần, chắc chắn là tạm thời)

DomainSchema

PropertyTypeDescription
backlinks* integer

Số lượng backlinks đến domain
refdomains* integer

Số lượng domain giới thiệu đến domain
traffic* number

Lưu lượng truy cập ước tính đến domain
value* integer

Giá trị tiền tệ của domain
keywords* integer

Số lượng từ khóa mà domain xếp hạng
domain_rating* number

Xếp hạng domain
ahrefs_rank* integer

Xếp hạng Ahrefs của domain

DomainsOut

Schema đại diện cho danh sách các domain.

PropertyTypeDescription
domains* array[string]

Domains

Email

PropertyTypeDescription
gmail* string

Địa chỉ Gmail.
outlook* string

Địa chỉ Outlook.

EmailForVerification

PropertyTypeDescription
email* string

Địa chỉ email để xác minh.
gmail* string

Địa chỉ Gmail để xác minh.
outlook* string

Địa chỉ Outlook để xác minh.

GmailCheckResponse

PropertyTypeDescription
email* string

Địa chỉ Gmail đã kiểm tra
status* string

Trạng thái tài khoản Gmail


Enum: Ok, Verify, Disable, NotExist, Disable|NotExist, Error
avatar string

GmailData

PropertyTypeDescription
email* string

Địa chỉ email của người dùng Gmail
timestamp* integer

Dấu thời gian của dữ liệu Gmail

HTTPValidationError

PropertyTypeDescription
detail array[object]

Detail

HtmlToMarkdownRequest

PropertyTypeDescription
html* string

Nội dung HTML để chuyển đổi sang Markdown (tối đa 500KB)


Example: <h1>Hello World</h1><p>This is a <strong>test</strong></p>
sanitize boolean

HtmlToMarkdownResponse

PropertyTypeDescription
success* boolean

Trạng thái thành công của yêu cầu
markdown* string

Nội dung Markdown đã chuyển đổi
tokens_saved* integer

Số lượng token đã tiết kiệm được khi sử dụng Markdown thay vì HTML (ước tính GPT-4)

IPLookupResponse

PropertyTypeDescription
is_valid* boolean

Liệu IP có được tìm thấy trong cơ sở dữ liệu hay không
country* string

Tên quốc gia đầy đủ (ví dụ: United States)
country_code* string

Mã quốc gia ISO 2 chữ cái (ví dụ: US)
region* string

Tên vùng/bang (ví dụ: Illinois)
region_code* string

Mã vùng/bang (ví dụ: IL)
city* string

Tên thành phố (ví dụ: Chicago)
zip* string

Mã bưu chính/ZIP (ví dụ: 60620)
lat number
lon number
timezone* string

Múi giờ IANA (ví dụ: America/Chicago)
isp* string

Tên ISP hoặc tổ chức
address* string

Phản hồi của địa chỉ IP đầu vào

InboxGmailItem

PropertyTypeDescription
mid* string

ID tin nhắn
textTo* string

Địa chỉ email người nhận
textFrom* string

Địa chỉ email người gửi
textSubject* string

Chủ đề của email
textDate* string

Ngày email được gửi

InboxGmailOut

PropertyTypeDescription
messages* array[object]

Danh sách các tin nhắn hộp thư đến Gmail

InboxItem

Schema đại diện cho một mục trong hộp thư đến.

PropertyTypeDescription
mid* string

Mid
textTo* string

Textto
textFrom* string

Textfrom
textSubject* string

Textsubject
textDate* string

Textdate
attachments array[object]

InboxMessage

Đại diện cho một tin nhắn trong hộp thư đến.

PropertyTypeDescription
mid* string

Mã định danh duy nhất cho tin nhắn
textDate* string

Ngày và giờ của tin nhắn
textTo* string

Người nhận tin nhắn
textFrom* string

Người gửi tin nhắn
textSubject* string

Chủ đề của tin nhắn

InboxOut

Schema đại diện cho đầu ra của hộp thư đến, chứa nhiều tin nhắn.

PropertyTypeDescription
messages* array[object]

Messages

InboxResponse

Mô hình phản hồi cho các tin nhắn hộp thư đến.

PropertyTypeDescription
messages* array[object]

Danh sách các tin nhắn hộp thư đến

ListGmailOut

PropertyTypeDescription
data* array[object]

Danh sách dữ liệu Gmail
pagination* object

Pagination

ListTempOutlookResponse

Mô hình phản hồi để liệt kê các mục Outlook tạm thời.

PropertyTypeDescription
data* array[object]

Danh sách các mục Outlook tạm thời
pagination* object

Đại diện cho thông tin phân trang cho các phản hồi danh sách.

LunarDateResponse

PropertyTypeDescription
solar_date* string

Ngày dương lịch được sử dụng (YYYY-MM-DD)
lunar_day* integer

Ngày âm lịch (1-30)
lunar_month* integer

Tháng âm lịch (1-12)
lunar_year* integer

Năm âm lịch
is_leap_month* boolean

Liệu có phải là tháng nhuận không
can_chi_year* string

Năm Can Chi (phụ thuộc ngôn ngữ)
can_chi_month* string

Tháng Can Chi (phụ thuộc ngôn ngữ)
can_chi_day* string

Ngày Can Chi (phụ thuộc ngôn ngữ)
moon_phase_value* number

Ngày trong chu kỳ Mặt Trăng 0.0-27.99 (0=trăng non, 14=trăng tròn)
moon_phase_name* string

Tên pha Mặt Trăng (phụ thuộc ngôn ngữ)
moon_phase_emoji* string

Biểu tượng cảm xúc pha Mặt Trăng
moon_illumination* number

Tỷ lệ chiếu sáng Mặt Trăng 0.0-1.0

MessageGmailOut

PropertyTypeDescription
body* string

Nội dung body của tin nhắn Gmail

MessageOut

Schema đại diện cho output của một message.

PropertyTypeDescription
body* string

Body
attachments array[object]

MessageResponse

Model phản hồi cho nội dung một message duy nhất.

PropertyTypeDescription
body* string

Nội dung body của message

MicrosoftCheckResponse

PropertyTypeDescription
email* string

Địa chỉ email Microsoft đã kiểm tra
status* string

Trạng thái tài khoản Microsoft


Enum: Ok, Verify(sms|2fa), NotExist, Error
details object

PageSchema

PropertyTypeDescription
backlinks* integer

Số lượng backlinks đến trang
refdomains* integer

Số lượng referring domains đến trang
traffic* number

Lưu lượng truy cập ước tính đến trang
value* integer

Giá trị tiền tệ của trang
keywords* integer

Số lượng keywords mà trang xếp hạng
url_rating* integer

Xếp hạng URL của trang
nr_words* integer

Số lượng từ trên trang

Payment

PropertyTypeDescription
bin integer

Bank Identification Number (BIN).

PhoneValidateResponse

PropertyTypeDescription
is_valid* boolean

Số điện thoại có hợp lệ hay không
is_formatted_properly* boolean

Đầu vào đã ở định dạng E.164 hay chưa
country* string

Tên quốc gia đầy đủ (ví dụ: Vietnam)
location* string

Tỉnh/khu vực liên quan đến tiền tố số
timezones* array[string]

Danh sách timezones cho khu vực
format_national* string

Định dạng hiển thị quốc gia (ví dụ: 0206 5550 100)
format_international* string

Định dạng hiển thị quốc tế (ví dụ: +84 206 5550 100)
format_e164* string

Định dạng chuẩn E.164 (ví dụ: +842065550100)
country_code* integer

Mã quốc gia quay số quốc tế (ví dụ: 84, 1, 44)

PublicAttachmentData

PropertyTypeDescription
id* string

Id
filename* string

Filename
size* integer

Size
mimeType* string

Mimetype

RandomGmailOut

PropertyTypeDescription
email* string

Địa chỉ Gmail ngẫu nhiên
timestamp* integer

Timestamp khi email được tạo
type* string

Loại email (real hoặc alias)


Enum: real, alias

RandomOutlookResponse

Mô hình Response cho một email Outlook tạm thời ngẫu nhiên.

PropertyTypeDescription
email* string

Địa chỉ email Outlook ngẫu nhiên
timestamp* integer

Timestamp khi email được tạo
type* string

Loại email (real hoặc alias)


Enum: real, alias

SendSmtpEmailRequest

PropertyTypeDescription
smtp_host* string

hostname của máy chủ SMTP (ví dụ: smtp.gmail.com)
smtp_port* integer

Port SMTP: 465 (SSL) hoặc 587 (STARTTLS)
smtp_user* string

username / email đăng nhập SMTP
smtp_pass* string

Password SMTP hoặc App Password
use_tls boolean
from_email* string

Địa chỉ email người gửi (From header)
from_name string
to* array[string]

Danh sách địa chỉ email người nhận
cc array[string]
bcc array[string]
reply_to string
subject* string

Dòng tiêu đề email
body_text string
body_html string

SendSmtpEmailResponse

PropertyTypeDescription
success* boolean

Cho biết email đã được gửi thành công hay chưa
message_id string
error_code string
error_message string

SmtpCheckCredRequest

PropertyTypeDescription
smtp_host* string

hostname của máy chủ SMTP (ví dụ: smtp.gmail.com)
smtp_port* integer

Cổng SMTP: 465 (SSL) hoặc 587 (STARTTLS)
smtp_user* string

Tên người dùng / email đăng nhập SMTP
smtp_pass* string

Mật khẩu SMTP hoặc Mật khẩu ứng dụng
use_tls boolean

SmtpCheckCredResponse

PropertyTypeDescription
success* boolean

True nếu thông tin xác thực hợp lệ và đăng nhập thành công
error_code string
error_message string

TempOutlookItem

Đại diện cho một item tạm thời trong hộp thư đến Outlook.

PropertyTypeDescription
emails* array[string]

Danh sách các địa chỉ email tạm thời
timestamp* integer

Unix timestamp của việc tạo item

UserGeneratorResponse

PropertyTypeDescription
name* string

Name
gender* string

Gender
dob* object

DateOfBirth
address_fake* string

Address Fake
address_real* object

Địa chỉ
phone_number_fake* string

Phone Number Fake
phone_number_real* string

Phone Number Real
email_for_verification* object

EmailForVerification
email* object

Email
username* string

Username
username_short* string

Username Short
password* string

Password
payment* object

Payment

ValidationError

PropertyTypeDescription
loc* array[object]

Location
msg* string

Message
type* string

Error Type

YcheckerOut

PropertyTypeDescription
type* string

Loại nhà cung cấp email
disposable* string

Email có phải là email dùng một lần không?
status* string

Trạng thái của email
avatar string

URL Avatar chỉ dành cho Gmail

Pagination

PropertyTypeDescription
page* integer

Số trang hiện tại
limit* integer

Số lượng mục trên mỗi trang
total_count* integer

Tổng số mục
total_pages* integer

Tổng số trang

Pagination

Đại diện cho thông tin phân trang cho các phản hồi danh sách.

PropertyTypeDescription
page* integer

Số trang hiện tại
limit* integer

Số lượng mục trên mỗi trang
total_count* integer

Tổng số mục
total_pages* integer

Tổng số trang