单笔同步招募创客接口

POST

/merchantapi/v2/projects/syncRecruit

单笔发起创客招募，并在当前请求内完成一次招募处理，返回当前处理结论。需要注意：同步返回“签约链接已生成”不等于创客已经完成签约，最终是否签约完成仍应以 SIGNED 回调或招募状态查询结果为准。

实际 HTTP POST 请求需按商户 API V2 通用规则，将业务参数 AES 加密后封装为 {"encryptedData":"..."}，并使用加密后的完整请求体参与 X-Sign 签名。加密前业务参数结构可参考示例“加密前业务参数示例”和数据模型 SyncRecruitBusinessRequest。

请求参数

Header 参数

Body 参数application/json必填

示例

实际 HTTP 请求体示例加密前业务参数示例

{
    "encryptedData": "U2FsdGVkX1+..."
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

实际 HTTP 请求体示例加密前业务参数示例

curl --location '/merchantapi/v2/projects/syncRecruit' \
--header 'X-App-Id: app_xxx' \
--header 'X-Timestamp: 1742891000000' \
--header 'X-Nonce: abc123' \
--header 'X-Sign: xxxx' \
--header 'X-Encrypt-Type: AES' \
--header 'Content-Type: application/json' \
--data '{
    "encryptedData": "U2FsdGVkX1+..."
}'

返回响应

🟢200

application/json

成功或业务失败均使用统一响应结构，业务结果以 code/message/data 为准。

Bodyapplication/json

示例

签约链接已生成已签约业务处理失败

{
    "code": 0,
    "message": "成功",
    "data": {
        "projectId": "2016422018623922178",
        "platformUserId": "DY20260115105692",
        "maskedPhone": "138****5678",
        "accepted": true,
        "message": "签约链接已生成",
        "errorCode": 0,
        "taskId": "2034454171060154370",
        "makerId": "2034454171060154371",
        "url": "https://sign.example.com/sign?token=3f2d8d44a8c34973a7359b6057f5fd5f"
    },
    "timestamp": 1742891000000,
    "requestId": "req_xxx",
    "encrypted": false,
    "signature": "xxxx"
}

⚪default

修改于 2026-06-24 02:57:16

批量招募创客

查询创客招募和签约状态