Json 如何在Marketo集成中使用API名称？

我在Marketo中创建了一个自定义活动，其字段名为

Permalink

，其API名称为

Permalink

使用

POST/rest/v1/activities/external.json

端点，我发送以下json以添加自定义活动

{
    "input": [
        {
            "activityDate": "2016-10-17T10:32:41+00:00",
            "activityTypeId": 100005,
            "attributes": [
                {
                    "apiName": "permalink",
                    "name": "Permalink",
                    "value": "https://facebook.com"
                }
            ],
            "leadId": "492",
            "primaryAttributeValue": "Test FB post"
        }
    ]
}

此调用成功并返回以下消息：

{
    "requestId": "81d8#157d25cb121",
    "result": [
        {
            "id": 2287,
            "status": "added"
        }
    ],
    "success": true
}

但是，当我不发送JSON中的

apiName

时（根据标准，它确实是可选的），它也能正常工作

我很想知道在哪里以及如何使用

apiName

。它的用途是什么？为什么是可选的？如果有任何文件，请告诉我，因为我找不到太多的信息