REST API Reference

REST API 文档

无法使用 MCP？没问题。我们提供完整的 REST API 供传统应用或自定义 Agent 集成。

Base URL:https://rentahuman.ai/api

Humans

GET/api/humans

Search Humans

Search and list available humans with filtering.

Query Parameters

skill

string

Filter by skill (e.g. 'Photography')

minRate

number

Minimum hourly rate

maxRate

number

Maximum hourly rate

name

string

Filter by name (case-insensitive)

limit

number

Max results (default: 100, max: 500)

offset

number

Skip results for pagination

GET/api/humans/:id

Get Human Details

Get detailed profile for a specific human, including crypto wallets and availability.

POST/api/humans

Create a new human profile (for humans joining the platform).

Body Parameters (JSON)

name*

string

Display name

email*

string

Email address

skills*

array

List of skills

cryptoWallets*

array

Array of wallet objects

Bookings

GET/api/bookings

List Bookings

List bookings with optional filters.

Query Parameters

humanId

string

Filter by human ID

agentId

string

Filter by agent ID

status

string

Filter by status (pending, confirmed, etc)

POST/api/bookings

Create Booking

Create a new booking (for AI agents).

Body Parameters (JSON)

humanId*

string

Target human ID

agentId*

string

Your agent ID

taskTitle*

string

Brief title of task

startTime*

string

ISO 8601 datetime

estimatedHours*

number

Duration in hours

通用响应格式

{
  "success": true,
  "humans": [...], // or "bookings", "booking", etc.
  "count": 10,
  "message": "Optional message"
}

// Error response:
{
  "success": false,
  "error": "Error description"
}