Create Custom APIs

Dev
1

What is the best method to create custom APIs on the discourse forum.

Eg: I want to create a get request which gives me users.count, topics.count, categories.count
How do I add this API into forum ?

2

You need to write a plugin. See Beginner’s Guide to Creating Discourse Plugins Part 1: Creating a basic plugin

4 Likes
3 
 /admin/about.json

Has most of that, I think. Or maybe it’s just /about.json.

1 Like
4

Not exactly the same data, so I want to create custom JSON API.

1 Like
5

I’ve been using https://github.com/discourse/discourse-subscriptions as a model for adding a model (you don’t need a full model, but https://github.com/discourse/discourse-subscriptions/blob/main/config/routes.rb gives you an example of how to add a route. That and add_to_class is most of what you need to know. Good luck!

1 Like
6

Thanks @pfaffman
Will look into it.

1 Like
7

I was unable to create a custom page/API through plugin.
Is there a beginner’s guide which I could follow ?? or any article that shows the basic steps.
I have followed discourse guide and was able to add settings to plugin but was unable to create a new page.
@pfaffman

8

I used the subscriptions plugin as a guide for one that I made. The plugin generator will generate a plugin with a new route. It’s complicated because you have both the rails and ember pieces to wrangle. If you want to add just a rails (api) route then it’s not too hard. (others might say that adding just an ember route is easy).

Do you need a new page to render in the browser or just the back end?

1 Like