Laravel 9集成Zoho Writer Merge and Sign遇merge_data未找到错误求助

问题描述 #

调用Zoho Writer的Merge and Sign API时，收到错误码R6001，提示：

Merge data not found. Please try again with proper merge data.

尝试过直接传数组和json_encode两种方式传递merge_data，均未解决问题。

核心问题分析 #

1. JSON序列化重复处理：Laravel的Http::post方法在设置Content-Type: application/json时，会自动将数组序列化为JSON字符串。手动调用json_encode会导致参数被嵌套序列化，API无法正确解析。
2. 字段名不匹配：原代码中merge_data的字段名带有前置空格（如' Gym_Name'），需确保与Zoho Writer文档中设置的合并字段名完全一致（包括大小写、空格）。

修正后的代码 #

public function SendWaiver()
{
    $accessToken = $this->getAccessToken();
    \Log::info('Access Token: ' . $accessToken['access_token']);

    // 定义签名者数据（直接用数组，无需手动转JSON）
    $signerData = [
        'recipient_1' => 'yfcrommelt@gmail.com',
        'action_type' => 'sign',
        'language' => 'en'
    ];

    // 定义合并数据（字段名与Zoho Writer文档完全匹配，无多余空格）
    $mergeData = [
        'data' => [
            [
                'Gym_Name' => 'Gym1',
                'Member_Name' => 'Ryle Traya',
                'Parent_Name' => 'Rommel Traya',
                'Contact_Phone_Number' => '09771054119'
            ]
        ]
    ];

    \Log::info('Merge Data : ' . json_encode($mergeData));

    $response = Http::withHeaders([
        'Authorization' => 'Zoho-oauthtoken ' . $accessToken['access_token'],
        'Content-Type' => 'application/json'
    ])->post('https://writer.zoho.com/api/v1/documents/kcrsoa321953c62f54fadba97ee1b525ef8c4/merge/sign', [
        'service_name' => 'zohosign',
        'filename' => 'Under Age Waiver',
        'signer_data' => $signerData,
        'merge_data' => $mergeData
    ]);

    return response()->json($response->json(), $response->status());
}

额外检查点 #

• 确认Zoho Writer文档中的合并字段名与代码中merge_data的键完全一致（大小写、空格均需匹配）。
• 验证API权限范围已包含Merge and Sign相关权限。
• 检查请求的文档ID是否正确，确保目标文档存在且已配置好合并字段。

内容的提问来源于stack exchange，提问作者Rommel Verterra Traya