CONTENT BUG: incomplete request syntax in API docs for Asset Objects

Anonymous
Not applicable

CONTENT BUG: incomplete request syntax in API docs for Asset Objects

FYI, the API documentation for the entire "Asset Objects" section has the a misleading typo for the API request syntax.
http://developers.marketo.com/documentation/asset-api/

Every API request example in the above section has the following format:
/asset/v1/email/1356/content

When these should instead read:
rest/asset/v1/email/1356/content

Here are two specific cases:
http://developers.marketo.com/documentation/asset-api/get-email-content-by-id/
http://developers.marketo.com/documentation/asset-api/get-email-template-content-by-id/

Note how most of the API docs present the example request:
http://developers.marketo.com/documentation/rest/get-list-by-id/

/rest/v1/lists/{id}.json

This can confuse a lot of developers...
Tags (1)
1 REPLY 1
Anonymous
Not applicable

Re: CONTENT BUG: incomplete request syntax in API docs for Asset Objects

Hi Lyndon

Exactly I think so.
In the first place,I misunderstood existing API's docs.
Becuse we get endpoint URL include "/rest".
http://developers.marketo.com/documentation/rest/endpoint-url/
0EM50000000T5OE.png
But API docs include /rest as you wrote.
/rest/v1/lists/{id}.json

In march release,I replaced /rest to /asset in my brain.
URL: <REST API Endpoint URL>/asset/v1/emailTemplate/{id}/content
This is correct format for new developers, but ...confuuuuuse!