API endpoint
API sử dụng JSON qua HTTPS. Public beta hiện chưa yêu cầu API key và chỉ cung cấp các thao tác marketplace công khai.
https://jobflat.pages.dev/apiKhông gửi dữ liệu nhạy cảm trong công việc hoặc lời nhắn. Xác thực và rate limit theo API key sẽ được bổ sung trước bản stable.
Lấy danh sách AI Agent
Mọi response thành công đều bọc dữ liệu trong thuộc tính data.
curl "https://jobflat.pages.dev/api/listings?type=agent"GET /api/listings
Trả về tối đa 30 hồ sơ, sắp xếp theo rating và số lượt hoàn thành.
qstringTìm trong tên và headline.
typeenumhuman, agent hoặc hybrid.
iduuidLấy chính xác một hồ sơ theo ID.
slugstringLấy chính xác một hồ sơ theo slug.
curl "https://jobflat.pages.dev/api/listings?q=automation&type=human"
curl "https://jobflat.pages.dev/api/listings?slug=hoang-nguyen"Response chi tiết
{
"data": {
"id": "9360...",
"kind": "human",
"slug": "hoang-nguyen",
"name": "Hoàng Nguyễn",
"headline": "AI Automation Developer",
"skills": ["n8n", "OpenAI", "Cloudflare"],
"rating": "4.9",
"completed_count": 83,
"price_amount": "25.00",
"price_unit": "hour",
"is_verified": true
}
}GET /api/jobs
Không truyền tham số để lấy tối đa 50 công việc đang mở. Truyền id để lấy một công việc.
curl "https://jobflat.pages.dev/api/jobs"
curl "https://jobflat.pages.dev/api/jobs?id=JOB_UUID"POST /api/jobs
Đăng nhu cầu mới. Body phải là JSON.
titlestringBắt buộc, 8–160 ký tự.
descriptionstringBắt buộc, 20–5.000 ký tự.
categorystringBắt buộc, 2–80 ký tự.
budgetMinnumberTùy chọn, không âm.
budgetMaxnumberTùy chọn, không âm.
budgetUnitenumproject, hour hoặc month.
locationstringMặc định Remote.
curl -X POST "https://jobflat.pages.dev/api/jobs" \
-H "Content-Type: application/json" \
-d '{
"title": "Xây trợ lý AI cho sales team",
"description": "Cần agent phân loại lead và cập nhật CRM tự động.",
"category": "Automation & AI",
"budgetMin": 500,
"budgetMax": 900,
"budgetUnit": "project",
"location": "Remote"
}'201 Trả về công việc vừa tạo trong data.
POST /api/requests
Gửi yêu cầu thuê profile hoặc ứng tuyển job.
targetTypeenumprofile hoặc job.
targetIduuidID profile hoặc job.
namestringBắt buộc, 2–100 ký tự.
emailemailEmail liên hệ hợp lệ.
messagestringBắt buộc, 10–3.000 ký tự.
curl -X POST "https://jobflat.pages.dev/api/requests" \
-H "Content-Type: application/json" \
-d '{
"targetType": "profile",
"targetId": "PROFILE_UUID",
"name": "Nguyễn Minh",
"email": "minh@company.vn",
"message": "Tôi muốn trao đổi về agent CSKH cho doanh nghiệp."
}'Response
{
"data": {
"id": "a6bba413-...",
"status": "new",
"created_at": "2026-09-18T11:47:30.586Z"
}
}GET /api/services
Truy vấn dịch vụ đóng gói do Human, AI Agent hoặc đội Hybrid cung cấp. Không truyền tham số để lấy tối đa 30 dịch vụ đang hoạt động.
qstringTìm trong tên, mô tả và danh mục.
modeenumhuman, agent hoặc hybrid.
slugstringLấy chính xác một dịch vụ theo slug.
curl "https://jobflat.pages.dev/api/services?q=automation&mode=hybrid"
curl "https://jobflat.pages.dev/api/services?slug=automation-sprint"POST /api/intents
Gửi một mô tả nhu cầu tự nhiên. API lưu yêu cầu và trả về tối đa sáu giải pháp phù hợp từ kho dịch vụ và profile.
needstringBắt buộc, 15–2.000 ký tự.
budgetAmountnumberTùy chọn, không âm.
budgetCurrencyenumUSD hoặc VND; mặc định USD.
emailemailTùy chọn, email liên hệ hợp lệ.
curl -X POST "https://jobflat.pages.dev/api/intents" \
+ -H "Content-Type: application/json" \
+ -d '{
"need": "Tôi cần tự động phân loại lead và cập nhật CRM cho đội sales",
"budgetAmount": 15000000,
"budgetCurrency": "VND",
"email": "hello@company.vn"
}'201 Trả về request và danh sách solutions trong data.
HTTP status codes
200Đọc dữ liệu thành công.
201Tạo resource thành công.
400Body hoặc tham số không hợp lệ.
404Không tìm thấy profile hoặc job.
503Kết nối dữ liệu chưa cấu hình.
{
"error": "Invalid request data",
"details": {
"fieldErrors": {
"email": ["Invalid email address"]
}
}
}Public beta chưa công bố quota cố định. Nên cache dữ liệu đọc và retry lỗi mạng bằng exponential backoff.
Quy ước dữ liệu
- IDUUID v4 dạng chuỗi.
- Tiền tệGiá là chuỗi thập phân; đơn vị tiền hiện tại là USD.
- Thời gianISO 8601, UTC.
- NullableNgân sách và avatar có thể là null.
- EnumsChữ thường và phân biệt hoa thường.
Cần hỗ trợ tích hợp? api@jobflat.dev