API Management

Quản lý API

Tạo và quản lý khóa API để truy cập theo chương trình vào tài khoản của bạn

Đăng nhập vào tài khoản của bạn để tạo và quản lý khóa API.

Tài Liệu API

Tiêu Đề Xác Thực

Bao gồm khóa API của bạn trong mỗi yêu cầu bằng cách sử dụng tiêu đề X-API-Key:

X-API-Key: your_api_key_here

Giới hạn tốc độ: 1.000 yêu cầu mỗi giờ mỗi khóa API

Điểm Cuối

Endpoints Tiêu Chuẩn

POST

/jobs/add

Tạo công việc/chiến dịch mới với các thông tin chi tiết đã chỉ định. Yêu cầu kiểu nội dung multipart/form-data. Đặt approve_once_full thành true để tự động phê duyệt tất cả các bài nộp và thanh toán cho người lao động khi công việc đạt tổng số lượng khả dụng.

Yêu Cầu

Content-Type: multipart/form-data

title: string (required)
description: string (required)
pay_rate: decimal (required)
total_availabilities: integer (required)
proof_required_description: string (required)
category: string (required)
sub_category: string (optional)
campaign_image: file (optional)
countries: array (optional. Omit to include all countries)
approve_once_full: boolean (optional, default: false. When true, all submissions are automatically approved and workers paid once the job reaches its total availabilities)

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job": {
    "public_id": "123e4567-e89b-12d3-a456-426614174000",
    "title": "Test Job",
    "status": "Active",
    "pay_rate": "5.00",
    "total_availabilities": 10
  },
  "deduction_details": {
    "total_cost": "50.00",
    "commission": "5.00",
    "total_deducted": "55.00",
    "new_balance": "945.00"
  }
}

Phản Hồi Lỗi

400 — Invalid data or insufficient balance
401 — Invalid or missing API key
403 — Job rejected by legitimacy check

Ví dụ Mã

import requests

# Create a job without image
job_data = {
    "title": "Complete a Survey",
    "description": "Fill out our 5-minute customer satisfaction survey",
    "pay_rate": "2.50",
    "total_availabilities": "100",
    "proof_required_description": "Submit a screenshot of the completion page",
    "category": "Survey",
    "sub_category": (None, "Customer Feedback"),
    "countries": (None, '["US", "CA", "GB"]'),  # Omit to include all countries
}
response = requests.post(
    "https://api.rapidworkers.io/jobs/add",
    headers={"X-API-Key": "your_api_key_here"},
    files=job_data
)
job = response.json()
print(f"Job created: {job['job']['public_id']}")

POST

/account/get_balance

Lấy số dư hiện tại của tài khoản bạn.

Yêu Cầu

Content-Type: application/json
{} // Empty body

Phản Hồi

// 200 OK
{
  "balance": "1000.00"
}

Phản Hồi Lỗi

401 — Invalid or missing API key
404 — User not found

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/account/get_balance",
    headers={"X-API-Key": "your_api_key_here"}
)
print(f"Balance: {response.json()['balance']}")

POST

/api/campaigns/{campaign_id}/submissions/{submission_id}/approve/

Duyệt bài nộp của người làm việc cho chiến dịch của bạn.

Tham Số Đường Dẫn

campaign_id (UUID)
submission_id (integer)

Yêu Cầu

Content-Type: application/json

{
  "notes": "Great work!" // Optional
}

Phản Hồi

// 200 OK
{
  "success": true,
  "message": "Submission approved successfully",
  "submission": {
    "id": 123,
    "user": "worker_username",
    "status": "Approved",
    "amount_paid": "5.00"
  }
}

Phản Hồi Lỗi

400 — Submission already processed or insufficient funds
403 — You don't own this campaign
404 — Submission not found

Ví dụ Mã

import requests

campaign_id = "your_campaign_public_id"
submission_id = 456

response = requests.post(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/{submission_id}/approve/",
    headers={"X-API-Key": "your_api_key_here"},
    json={"notes": "Great work!"}
)
print(f"Submission approved: {response.json()}")

POST

/api/campaigns/{campaign_id}/submissions/{submission_id}/reject/

Từ chối bài nộp của người làm việc với lý do.

Tham Số Đường Dẫn

campaign_id (UUID)
submission_id (integer)

Yêu Cầu

Content-Type: application/json

{
  "notes": "Does not meet requirements" // Required
}

Phản Hồi

// 200 OK
{
  "success": true,
  "message": "Submission rejected",
  "submission": {
    "id": 123,
    "user": "worker_username",
    "status": "Rejected",
    "notes": "Does not meet requirements"
  }
}

Phản Hồi Lỗi

400 — Missing rejection reason
403 — You don't own this campaign
404 — Submission not found

Ví dụ Mã

import requests

campaign_id = "your_campaign_public_id"
submission_id = 456

response = requests.post(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/{submission_id}/reject/",
    headers={"X-API-Key": "your_api_key_here"},
    json={"notes": "Screenshot does not show completion page"}
)
print(f"Submission rejected: {response.json()}")

POST

/api/campaigns/{campaign_id}/submissions/bulk_action/

Duyệt tất cả bài nộp đang chờ của một chiến dịch cùng một lúc.

Tham Số Đường Dẫn

campaign_id (UUID)

Yêu Cầu

Content-Type: application/json

{
  "notes": "Bulk action notes" // Optional
}

Phản Hồi

// 200 OK
{
  "success": true,
  "message": "All submissions approved successfully.",
  "submissions": [
    { "id": 123, "status": "Approved", "user": "worker1" },
    { "id": 124, "status": "Approved", "user": "worker2" }
  ]
}

Phản Hồi Lỗi

403 — You don't own this campaign
404 — No pending submissions found

Ví dụ Mã

import requests

campaign_id = "your_campaign_public_id"

# Bulk approve all pending
response = requests.post(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/bulk_action/",
    headers={"X-API-Key": "your_api_key_here"},
    json={"notes": "All submissions verified"}
)
print(f"Bulk action result: {response.json()}")

GET

/api/campaigns/

Truy xuất tất cả hoạt động của người dùng đã được xác minh, với tùy chọn lọc theo trạng thái.

Yêu Cầu

Query Parameters (optional):

status: string ("Active", "Pending", "Completed", "Canceled")
language: string (default: "en")

Phản Hồi

// 200 OK
[
  {
    "jobId": "123e4567-e89b-12d3-a456-426614174000",
    "jobTitle": "Complete a Survey",
    "jobCategory": "Survey",
    "jobPay": "2.50",
    "jobLocation": "In",
    "jobCreatedAt": "2025-01-15T10:30:00Z",
    "jobStatus": "Active",
    "jobInstancesCompleted": 45,
    "jobTotalAvailabilities": 100,
    "jobSuccessRate": "40%",
    "description": "Fill out our customer satisfaction survey",
    "canceled": false,
    "remainingAvailabilities": 55,
    "pendingSubmissions": 12,
    "approvedSubmissions": 40,
    "rejectedSubmissions": 5
  }
]

Phản Hồi Lỗi

401 — Invalid or missing API key

Ví dụ Mã

import requests

# List all campaigns
response = requests.get(
    "https://api.rapidworkers.io/api/campaigns/",
    headers={"X-API-Key": "your_api_key_here"}
)
campaigns = response.json()
for campaign in campaigns["results"]:
    print(f"{campaign['jobTitle']} - {campaign['jobStatus']}")

# Filter by status
response = requests.get(
    "https://api.rapidworkers.io/api/campaigns/?status=Active",
    headers={"X-API-Key": "your_api_key_here"}
)

GET

/api/campaigns/detail/{campaign_id}/

Truy xuất thông tin chi tiết về một chiến dịch cụ thể bao gồm số lượng bài nộp và khả năng còn lại.

Tham Số Đường Dẫn

campaign_id (UUID)

Yêu Cầu

Query Parameters (optional):

language: string (default: "en")

Phản Hồi

// 200 OK
{
  "jobId": "123e4567-e89b-12d3-a456-426614174000",
  "jobTitle": "Complete a Survey",
  "jobCategory": "Survey",
  "jobPay": "2.50",
  "jobLocation": "In",
  "jobCreatedAt": "2025-01-15T10:30:00Z",
  "jobStatus": "Active",
  "jobInstancesCompleted": 45,
  "jobTotalAvailabilities": 100,
  "jobSuccessRate": "40%",
  "description": "Fill out our customer satisfaction survey",
  "canceled": false,
  "remainingAvailabilities": 55,
  "pendingSubmissions": 12,
  "approvedSubmissions": 40,
  "rejectedSubmissions": 5
}

Phản Hồi Lỗi

401 — Invalid or missing API key
403 — You don't own this campaign
404 — Campaign not found

Ví dụ Mã

import requests

campaign_id = "123e4567-e89b-12d3-a456-426614174000"
response = requests.get(
    f"https://api.rapidworkers.io/api/campaigns/detail/{campaign_id}/",
    headers={"X-API-Key": "your_api_key_here"}
)
campaign = response.json()
print(f"Remaining slots: {campaign['remaining_availabilities']}")
print(f"Pending: {campaign['pending_submissions']}")

GET

/api/campaigns/{campaign_id}/submissions/

Truy xuất tất cả bài nộp của một chiến dịch cụ thể với siêu dữ liệu người lao động, bộ lọc trạng thái tùy chọn và phân trang.

Tham Số Đường Dẫn

campaign_id (UUID)

Yêu Cầu

Query Parameters (optional):

status: string ("Pending", "Approved", "Rejected")
search: string (search by worker name)
page: integer (default: 1)
rowsPerPage: integer (default: 1000)
language: string (default: "en")

Phản Hồi

// 200 OK
{
  "count": 45,
  "next": null,
  "previous": null,
  "results": {
    "submissions": [
      {
        "submissionId": 123,
        "userId": "abc-def-123",
        "userName": "WorkerName",
        "userAvatar": "https://...",
        "campaignId": "123e4567-e89b-12d3-a456-426614174000",
        "campaignTitle": "Complete a Survey",
        "status": "Pending",
        "country_name": "United States",
        "submittedAt": "2025-01-16T14:30:00Z",
        "proof_text": "Completed the survey as requested",
        "images": [
          { 
            "id": "img_1", 
            "url": "https://...", 
            "thumbnailUrl": "https://..." 
          }
        ],
        "notes": null,
        "workerAccountAgeDays": 120,
        "workerApprovalRate": "85%",
        "workerTotalCompleted": 47
      }
    ],
    "pagination": {
      "totalCount": 45,
      "pageCount": 1,
      "currentPage": 1,
      "rowsPerPage": 1000
    }
  }
}

Phản Hồi Lỗi

401 — Invalid or missing API key
403 — You don't own this campaign
404 — Campaign not found

Ví dụ Mã

import requests

campaign_id = "123e4567-e89b-12d3-a456-426614174000"

# List all submissions
response = requests.get(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/",
    headers={"X-API-Key": "your_api_key_here"}
)
data = response.json()
for sub in data["results"]["submissions"]:
    print(f"#{sub['submissionId']} - {sub['status']} - Age: {sub['worker_account_age_days']}d")

# Filter pending only
response = requests.get(
    f"https://api.rapidworkers.io/api/campaigns/{campaign_id}/submissions/?status=Pending",
    headers={"X-API-Key": "your_api_key_here"}
)

POST

/api/workers/block/

Chặn một người lao động gửi bằng chứng cho bất kỳ chiến dịch nào của bạn. Người lao động bị chặn sẽ không thấy chiến dịch của bạn trong danh sách công việc.

Yêu Cầu

Content-Type: application/json

{
  "worker_id": 12345 // Worker public ID
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Worker blocked successfully",
  "worker_id": 12345
}

Phản Hồi Lỗi

400 — Missing worker_id, self-block attempt, or worker already blocked
401 — Invalid or missing API key
404 — Worker not found

Ví dụ Mã

import requests

worker_id = 12345

response = requests.post(
    "https://api.rapidworkers.io/api/workers/block/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={"worker_id": worker_id}
)
print(f"Worker blocked: {response.json()}")

POST

/api/workers/unblock/

Bỏ chặn một người lao động đã bị chặn trước đó, cho phép họ xem và gửi bằng chứng cho chiến dịch của bạn một lần nữa.

Yêu Cầu

Content-Type: application/json

{
  "worker_id": 12345
}

Phản Hồi

// 200 OK
{
  "success": true,
  "message": "Worker unblocked successfully",
  "worker_id": 12345
}

Phản Hồi Lỗi

400 — Missing worker_id or worker is not blocked
401 — Invalid or missing API key
404 — Worker not found

Ví dụ Mã

import requests

worker_id = 12345

response = requests.post(
    "https://api.rapidworkers.io/api/workers/unblock/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={"worker_id": worker_id}
)
print(f"Worker unblocked: {response.json()}")

GET

/api/workers/blocked/

Truy xuất danh sách tất cả người lao động mà bạn đã chặn.

Yêu Cầu

No request body required.

Phản Hồi

// 200 OK
[
  {
    "worker_id": 12345,
    "worker_name": "WorkerName",
    "blocked_at": "2025-01-15T10:30:00Z"
  }
]

Phản Hồi Lỗi

401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.get(
    "https://api.rapidworkers.io/api/workers/blocked/",
    headers={"X-API-Key": "your_api_key_here"}
)
blocked = response.json()
for worker in blocked:
    print(f"Blocked: {worker['worker_name']} (ID: {worker['worker_id']})")

Endpoints Công Việc Có Sẵn

Endpoints đơn giản hóa cho các nhiệm vụ tương tác trên mạng xã hội phổ biến. Chỉ yêu cầu liên kết và số lượng. Tất cả công việc được điền sẵn đều bật phê duyệt tự động: các bài nộp được tự động phê duyệt và người lao động được thanh toán khi công việc đạt tổng số lượng khả dụng.

POST

/api/jobs/facebook-likes/

Tạo công việc đơn giản để nhận lượt thích bài đăng Facebook. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://facebook.com/post/123", // Required
  "quantity": 50, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "2.50"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/facebook-likes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://facebook.com/post/123",
        "quantity": 50  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/facebook-shares/

Tạo công việc đơn giản để nhận lượt chia sẻ bài đăng Facebook. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://facebook.com/post/123", // Required
  "quantity": 25, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "1.25"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/facebook-shares/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://facebook.com/post/123",
        "quantity": 25  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/instagram-likes/

Tạo công việc đơn giản để nhận lượt thích bài đăng Instagram. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://instagram.com/ABC123", // Required
  "quantity": 100, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "5.00"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/instagram-likes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://instagram.com/ABC123",
        "quantity": 100  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/instagram-followers/

Tạo công việc đơn giản để tăng người theo dõi Instagram. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://instagram.com/username", // Required
  "quantity": 50, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "2.50"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/instagram-followers/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://instagram.com/username",
        "quantity": 50  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/twitter-likes/

Tạo công việc đơn giản để nhận lượt thích bài đăng Twitter/X. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://twitter.com/user/status/123", // Required
  "quantity": 75, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "3.75"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/twitter-likes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://twitter.com/user/status/123",
        "quantity": 75  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/twitter-followers/

Tạo công việc đơn giản để tăng người theo dõi Twitter/X. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://twitter.com/username", // Required
  "quantity": 50, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "2.50"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/twitter-followers/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://twitter.com/username",
        "quantity": 50  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/twitter-retweets/

Tạo công việc đơn giản để nhận retweet Twitter/X. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://twitter.com/user/status/123", // Required
  "quantity": 30, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "1.50"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/twitter-retweets/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://twitter.com/user/status/123",
        "quantity": 30  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/trustpilot-reviews/

Tạo công việc đơn giản để nhận đánh giá Trustpilot. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://trustpilot.com/review/example.com", // Required
  "quantity": 20, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "1.00"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/trustpilot-reviews/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://trustpilot.com/review/example.com",
        "quantity": 20  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/9gag-upvotes/

Tạo công việc đơn giản để nhận lượt vote 9GAG. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://9gag.com/gag/abc123", // Required
  "quantity": 50, // Required (minimum: 6)
  "countries": ["US", "GB"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "2.50"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/9gag-upvotes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://9gag.com/gag/abc123",
        "quantity": 50  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

POST

/api/jobs/youtube-likes/

Tạo công việc đơn giản để nhận lượt thích video YouTube. Chỉ yêu cầu liên kết và số lượng. Auto-pricing: $0.05 per job. Các bài nộp được tự động phê duyệt khi công việc đã đầy.

Yêu Cầu

Content-Type: application/json

{
  "link": "https://youtube.com/watch?v=abc123", // Required
  "quantity": 100, // Required (minimum: 6)
  "countries": ["US", "CA"], // Omit to include all countries
  "language": "en", // Optional
  "approve_once_full": true // Optional (default: true). Auto-approve all submissions once job is full
}

Phản Hồi

// 201 Created
{
  "success": true,
  "message": "Job created successfully",
  "job_id": "123e4567-e89b-12d3-a456-426614174000",
  "total_cost": "5.00"
}

Phản Hồi Lỗi

400 — Invalid data, insufficient balance, or quantity below minimum (6)
401 — Invalid or missing API key

Ví dụ Mã

import requests

response = requests.post(
    "https://api.rapidworkers.io/api/jobs/youtube-likes/",
    headers={"X-API-Key": "your_api_key_here", "Content-Type": "application/json"},
    json={
        "link": "https://youtube.com/watch?v=abc123",
        "quantity": 100  # Minimum: 6
    }
)
job = response.json()
print(f"Job created: {job['job_id']}")

Xử Lý Lỗi

Tất cả lỗi API tuân theo định dạng nhất quán:

{
  "error": "Error message describing what went wrong"
}

Mã Trạng Thái HTTP Phổ Biến:

200 Yêu cầu thành công
201 Tài nguyên đã được tạo thành công
400 Dữ liệu yêu cầu không hợp lệ
401 Thiếu khóa API hoặc khóa không hợp lệ
403 Quyền không đủ
404 Không tìm thấy tài nguyên
429 Vượt quá giới hạn tốc độ (1.000/giờ)
500 Lỗi phía máy chủ