Main endpoints

Pagination and Query Parameters

DegDitor's API supports pagination by default.
  • page: which page of results (default: 1)
  • itemsPerPage: how many items to return (default: 30)
You can combine these with filters, search parameters, and ordering options as shown below.

Core Endpoints

DegDitor exposes content types via these REST API endpoints:

Images

GET /api/v2/shop/degditor/images/{id}/
Fetch an image by ID
GET /api/v2/shop/degditor/images/{id}/?img_w=480,960,1280
Fetch a scaled image at different witdhs

Tip

The img_w parameter is available on any endpoint that returns images — including pages, categories, and blocks.

Categories

GET /api/v2/shop/degditor/categories/{id}/
Fetch a single category by ID
GET /api/v2/shop/degditor/categories-by-slug/{slug}/
Fetch a single category slug
GET /api/v2/shop/degditor/categories/
Fetch all categories

Filtering examples:

/api/v2/shop/degditor/categories/?isShownInMenu=1
Retrieves only categories shown in the menu
/api/v2/shop/degditor/categories/?order[position]=asc
Retrieves categories sorted by their position (asc | desc)

Pages

GET /api/v2/shop/degditor/pages/{id}/
Fetch a single page by ID
GET /api/v2/shop/degditor/pages-by-slug/{slug}/
Fetch a single page slug
GET /api/v2/shop/degditor/pages/
Fetch all pages

Filtering examples:

/api/v2/shop/degditor/pages/?isHomepage=1
Retrieves only homepages
/api/v2/shop/degditor/pages/?isShownInMenu=1
Retrieves only pages shown in the menu
/api/v2/shop/degditor/pages/?order[position]=asc
Retrieves pages sorted by their position (asc | desc)
/api/v2/shop/degditor/pages/?exists[fragment]=0
Retrieves only non-fragment pages
/api/v2/shop/degditor/pages/?exists[fragment]=1
Retrieves only fragment pages
/api/v2/shop/degditor/pages/?fragment=hero_banner
Retrieves pages matching that fragment (the comparison is partial, not exact, see docs)
/api/v2/shop/degditor/pages/?title=About%20Us
Retrieves pages matching that title (the comparison is partial, not exact, see docs)
/api/v2/shop/degditor/pages/?categories.id=1
Retrieves pages in a category
/api/v2/shop/degditor/pages/?categories.id[]=1&categories.id[]=2
Retrieves pages in multiple categories

Blocks

GET /api/v2/shop/degditor/pages/{pageId}/blocks/
Get all blocks for a given page
GET /api/v2/shop/degditor/{pageId}/blocks/{id}
Get a specific block from a page
Each block is rendered with its associated template and configured attributes.
You can use this endpoint to build custom renderers or fully dynamic layouts on the frontend.

Best Practices

  • Always cache API responses when possible — especially for published pages and fragments — to reduce load and improve performance.
  • Use preview tokens carefully and avoid exposing them publicly in frontend code.
  • Use img_w for responsive image rendering to reduce payload and improve loading speed across devices.
  • Use filtering to only fetch what you need, especially when working with large catalogs or CMS hierarchies.

Use Cases

  • Render full landing pages using GET /pages-by-slug/{slug}
  • Render reusable content fragments (like banners, hero sliders, footers) using the fragments filter
  • Build a custom menu based on categories shown in menu
  • Create dynamic homepage layouts powered by block configuration
  • Preview unpublished content with a secure token in staging environments
Three, two, one...

Ready for DegDitor?

Try the plugin

Experience the best features at no cost

Get a better understanding of DegDitor and how it works

Test it risk-free and see the results

Try it

Get a demo

Get a personalized demo tailored to your unique needs

Preview our pricing plans

Evaluate DegDitor against your requirements

Get a demo

We are here for you

After months of intense development, it’s time to put DegDitor to work. For feedback, questions or information please contact us!

Contact us