Contesimal

wondermentapps

Contesimal Connector adds REST API endpoints to your WordPress site, allowing external applications to create and manage content using an API key.

Requests are made to your site’s <code>/wp-json/contesimal/v1/</code> endpoints. The plugin does not send any data externally on its own.

External services and privacy

<ul>
<li>Service: Designed to work with Contesimal (https://contesimal.ai), but compatible with any client using your API key.</li>
<li>Data received: Post title, content (HTML), excerpt, status, categories, tags, post type, author ID, and media URLs. The optional users endpoint returns public-style author fields (ID, display name, slug) for users who can edit posts—no passwords or email.</li>
<li>Media handling: Your WordPress site may download remote files from provided URLs to create Media Library attachments.</li>
<li>When: Only when a valid API request is sent to your site. No background communication occurs.</li>
<li>Control: External access is enabled only if you share the API key. You can regenerate the key or deactivate the plugin at any time.</li>
<li>Consent: By enabling the plugin and sharing the API key, the site administrator allows external applications to submit content.</li>
</ul>

Authentication

All endpoints require an API key sent in the <code>X-API-Key</code> header (or <code>Authorization: Bearer</code>).

The key is:
– Generated on your site
– Stored as a secure hash
– Managed by administrators only

Requests without a valid key are rejected (401). Rate limiting is applied per IP.

API keys should be treated as sensitive credentials and only shared with trusted systems.

Features

<ul>
<li>API key authentication (hashed storage)</li>
<li>Create posts via REST API</li>
<li>List categories, post types, and author-capable users (IDs for <code>author_id</code>)</li>
<li>Media import from external URLs</li>
<li>Rate limiting (per IP)</li>
<li>Configurable CORS</li>
<li>Optional request logging (admin only)</li>
</ul>

REST endpoints (base: <code>/wp-json/contesimal/v1</code>)

<ul>
<li><code>GET /ping</code> – Health check</li>
<li><code>GET /categories</code> – List categories</li>
<li><code>GET /post-types</code> – List public post types</li>
<li><code>GET /users</code> – List users with <code>edit_posts</code> (optional <code>session_only</code>, <code>search</code>, <code>limit</code>)</li>
<li><code>GET /posts</code> – List posts by post type with pagination and total count</li>
<li><code>POST /publish</code> – Create post</li>
<li><code>POST /media/import</code> – Import media from URLs</li>
</ul>

An admin notice is shown when API access is enabled, indicating that external publishing is active.

<h3>REST API Reference</h3>

All endpoints require: <code>X-API-Key: your_api_key</code>

<h4>GET /wp-json/contesimal/v1/ping</h4>

Returns plugin status.

Response:
{ “status”: “ok”, “plugin”: “contesimal-connector”, “version”: “1.0.0” }

<h4>GET /wp-json/contesimal/v1/categories</h4>

Returns category list.

<h4>GET /wp-json/contesimal/v1/post-types</h4>

Returns public post types.

<h4>GET /wp-json/contesimal/v1/users</h4>

Returns users who can author posts (<code>edit_posts</code>), suitable for <code>author_id</code> on <code>POST /publish</code>.

Query parameters (all optional):




 Parameter
 Description




 search
 Substring match on login, nicename, or display name


 session_only
 <code>1</code> to only include users with stored WordPress session tokens (typically logged in recently)


 limit
 Max results, 1–200 (default 200)




Response (example):
{ “success”: true, “users”: [ { “id”: 1, “name”: “Site Admin”, “slug”: “admin” } ] }

<h4>GET /wp-json/contesimal/v1/posts</h4>

Returns a paginated list of posts for a given post type, plus the total count for that filter.

Query parameters (all optional):




 Parameter
 Description




 post_type
 Public post type (default <code>post</code>)


 per_page
 1–100, default 50


 offset
 Number of posts to skip (default 0)


 status
 Comma-separated status list (default <code>publish</code>), or <code>any</code>


 search
 Optional keyword across title/content




Response (example):
{ “success”: true, “post_type”: “post”, “total”: 124, “per_page”: 50, “offset”: 0, “count”: 50, “posts”: [ { “post_id”: 42, “title”: “Hello world”, “slug”: “hello-world”, “status”: “publish”, “date”: “2026-05-14T11:50:00+00:00”, “author_name”: “Site Admin”, “link”: “https://example.com/hello-world/”, “featured_image”: “https://example.com/wp-content/uploads/2026/05/cover.jpg”, “featured_image_id”: 99, “categories”: [ “News”, “Updates” ], “tags”: [ “Announcement”, “WordPress” ], “content”: “

Hello

” } ] }

<h4>POST /wp-json/contesimal/v1/publish</h4>

Creates a post.

Headers:
Content-Type: application/json 
X-API-Key: your_api_key

Body:




 Field
 Type
 Required
 Description




 title
 string
 Yes
 Post title


 content
 string
 Yes
 HTML content


 status
 string
 No
 publish, draft, pending, private


 excerpt
 string
 No
 Post excerpt


 post_type
 string
 No
 Default: post


 category_ids
 array
 No
 Category IDs


 tags
 array
 No
 Tag names


 featured_image_url
 string
 No
 Image URL


 author_id
 integer
 No
 Default: 1




Responses:
– 200 Success
– 400 Bad request
– 401 Invalid API key
– 429 Rate limit exceeded
– 500 Server error

Contesimal Connector

Publish content to WordPress from external applications via a secure REST API using API key authentication.

Veda

EasyProLabs

Easily display post grid, list or post sliders. Display post types provides easiest way to fetch, sort and display list of posts, pages or any custom post types using block or widget.
<iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/qn2164Iodac?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe>
Display Post Types is the ultimate plugin to showcase your WordPress posts, pages, or custom post types in visually stunning grids, lists, and sliders. Whether you’re displaying blog posts, portfolios, or any custom content, this plugin makes it incredibly easy and flexible, with no coding skills required.
<h3>Key Features</h3>
<ul>
<li>
Versatile Display Options: 
Present your content as a post grid, post list, or dynamic post slider. Choose from multiple layouts like grid, masonry, list, mini list, and overlay styles.
</li>
<li>
Customizable Layouts: 
Adjust columns, crop images, and control slider settings, including auto-slide functionality, for a fully tailored design.
</li>
<li>
Content Control: 
Select specific post types (Posts, Pages, or Custom Post Types) and refine with filters using categories, tags, and custom taxonomies. Advanced options include sorting by date, title, author, comments, or even random order.
</li>
<li>
Pagination & Offset: 
Easily manage pagination and exclude initial posts using the offset feature to curate the perfect display.
</li>
<li>
User-Friendly Interface: 
Utilize intuitive blocks, widgets, or shortcodes to add post displays anywhere on your site with just a few clicks.
</li>
<li>
Responsive Design: 
All layouts are fully responsive and mobile-friendly, ensuring your content looks great on any device.
</li>
<li>
Customization Made Easy: 
Fine-tune each layout using built-in tools for a seamless user experience.
</li>
</ul>
<h3>Why Choose Display Post Types?</h3>
Whether you’re a blogger, business owner, or designer, Display Post Types gives you the flexibility to present your content exactly how you envision it. The possibilities are endless, allowing you to create anything from clean and simple post grids to advanced, auto-sliding sliders.
<h3>Quick Start Video</h3>
Need help getting started? Watch our step-by-step tutorial to learn how to use Display Post Types and unlock its full potential.
<a href="https://youtu.be/tTVGMylfBhU?si=qr1YtkqaXJck9xc-" rel="nofollow ugc">Watch the Tutorial</a>
<h4>What this plugin offers</h4>
<ul>
<li>Fetch any post, page or post types using available filters and sort your selection.</li>
<li>Choose what content items to be displayed (from available options)</li>
<li>Choose a style to display your content. You can choose from list, grid or slider views. Variuos customization options</li>
<li>Live preview of your changes in the display post types block.</li>
</ul>
<h4>Need more layouts and customization options?</h4>
<ul>
<li>Get more features, layouts and customization options with <a href="https://easyprolabs.com/display-post-types/" rel="nofollow ugc">Display Post Types Pro</a></li>
<li>Check <a href="https://easyprolabs.com/display-post-types-demo/" rel="nofollow ugc">sample layouts</a> made possible by Display Post Types Pro.</li>
<li>Option to display custom fields and shortcodes in the display post types.</li>
<li><a href="https://easyprolabs.com/display-post-types" rel="nofollow ugc">Get Display Post Types Pro</a></li>
</ul>
<h4>Setup DPT Widget</h4>
Display post types in any widget area of your website.
<ol>
<li>After activating the plugin, visit Appearance > Widgets in admin dashboard.</li>
<li>Look for ‘Display Post Types’ widget in left ‘Available Widgets’ section.</li>
<li>Drag the widget to any available sidebar/widget area.</li>
<li>Select a post type to be displayed.</li>
<li>Select various filter, sort and styling options to make a unique layout.</li>
<li>Click [Save] button.</li>
</ol>
<h4>Setup DPT Block</h4>
Display post types list on any post or page using editor block. Make sure you have not disabled WordPress latest block editor.
Setup
<ol>
<li>After activating the plugin, visit any post or page’s edit screen.</li>
<li>In main content area, click on ‘+’ icon to add a new block.</li>
<li>Search for ‘Display Post Types’ block or Select from “Layout Elements > Display Post Types”.</li>
<li>Select a post type to be displayed.</li>
<li>Select various filter, sort and styling options to make a unique layout.</li>
<li>Click [Publish] or [Update] button.</li>
</ol>

Display Post Types – Post Grid, post list and post sliders

Display list of posts, pages or any custom post types anywhere using block and widget. Show as grid, list or posts slider.

Contesimal Connector vs Display Post Types – Post Grid, post list and post sliders