Where's the API call being used?

Question

Some legacy code on the lithium board I took over have the call below:

<#assign messages = rest("/topics/style/blog/recent?page_size=3").messages />

So where is this rest call explained?

At the API documentation pages the closest I can find is: https://lithosphere.lithium.com/t5/rest-api/bd-p/developers-rest-api?leaf-id=Blog.topics#Blog.topics.style.style.recent

However, the resource URL for that looks far different from the one used in the component I;m looking at. What's the discrepancy?

suzieh · Answer

Hi,
I wanted to chime in here from the Documentation team to let you know that we completely understand your frustration and that we're working on making the documentation (across the Lithosphere and Developer Network) more manageable. We're working toward clear categories, less duplication, and more consistency overall. With regard to the REST API, we're in the process of reviewing the calls and getting better examples with complete parameter definitions. The first phase is coming in the next month for better REST API docs. Thanks for the detailed feedback.&nbsp;
&nbsp;
Suzie

beryllium · Answer

Thanks Adam,&nbsp;Some thoughts for lithium:&nbsp;1. So when I look at the documentation for both calls, they look very similiar except for the the example URL. It makes it very difficult to find the call as I'm sure you can see. &nbsp;I find this to be a shortcoming of the documentation.&nbsp;&nbsp;2. Furthermore, why aren't the discussion_style options linked form the documentation page? I constantly feel like I need to look in a hundred different places for everything I'm doing. Why not make it easier for me by linking everything relevant next to the call.&nbsp;3. Actually having an example using a rest() call with the path would also have helped.&nbsp;4. In addition to the discussion_style, I also had no idea where to find the "rest" context object &nbsp;options.&nbsp;&nbsp;Put those four together, and I've found that the lithium documentation is difficult at best. It's far too spread out, if you can even find it. There's a lot of improvement to be had here, and I think it would be rather simple to accomplish.&nbsp;Even now that I know this, when I later go to reference the API documentation, I will most likely find myself yet again in a spot where I need to find the possible values of discussion_style and the options for the rest context object. I have to book mark things and then find them there. Please consider better referencing within the docs.

adamn · Answer

I think this may be the one you're looking for:
https://lithosphere.lithium.com/t5/rest-api/bd-p/developers-rest-api?leaf-id=Community.topics#Community.topics.style.style.recent
"topics/style/[style]&nbsp;/recent"

adamn · Answer

It's not the same, actually. What you linked was within a Blog context. What I linked was in a Community context. I thought that was the nature of your question. Apologies for the misunderstanding.
&nbsp;
Now that I understand your question better, let me try to address it. When you're working with the rest custom context object, you do not need to specify the full path. You can instead, specify a relative path because it's understood that the call is being made to the current community. So you can cut everything off at the http://community.yourdomain.com/restapi/vc, and just use what's after that for the call.
&nbsp;
Here's more about the "rest" context object:
http://lithosphere.lithium.com/t5/developers-knowledge-base/Context-objects-for-custom-components-rest/ta-p/9333
&nbsp;
You can find the possible values for the "discussion_style" type here:
https://lithosphere.lithium.com/t5/rest-api/bd-p/developers-rest-api?page=apicall

beryllium · Answer

Isn't that exactly the same link I was linking too?

My point is that the call as described in the API looks nothing like the call does when it's used.

How does the resource description:

"http://community.lithium.com/community-name/restapi/vc/topics/style/[style] /recent"

Get translated into "topics/style/[style] /recent"

I found that part to be confusing.

Also, there's no description of what "[style]" should be in the documentation. How do I know that the options could be "blog" ?

Forum Discussion

Where's the API call being used?

Related Content

When Product Bugs are deferred / cannot be fixed.

Help Us Help You!

Where to find Community Alpanumeric ID in Admin? or...?

Hermes skin - Where is this button controlled?

Using the Khoros Community Case Portal

Recent Discussions

Does anyone know how to change the display title of Custom Fields in Aurora?

Can someone walk me through authenticating and using Postman with Aurora?

Seeking Advice on Restricting Access to a posts to those who have the permalink.

TinyMceEditor is undefined

400/404 error on POST request