Jonathan Miller
122c7b630a
- Telegram: updated default bot from @MokoWaaSBot to @mokosuite_bot - Telegram: embedded obfuscated bot token in plugin PHP (XOR + base64) - Telegram: added <config> section to plugin XML for parse_mode/preview - Telegram: removed bot token from admin-visible plugin params - Branding: replaced all MokoWaaS references with MokoSuite - Wiki: reorganized into getting-started/, user-guide/, services/, developer/ - README: updated with all 36 service plugins and current features - CHANGELOG: added entries for recent fixes and changes
58 lines
1.5 KiB
Markdown
58 lines
1.5 KiB
Markdown
# REST API
|
|
|
|
MokoSuiteCross includes a WebServices plugin that provides REST API endpoints via Joomla's API application.
|
|
|
|
## Authentication
|
|
|
|
All endpoints require a Joomla API token. Generate one in **Users → Manage → [User] → API Tokens**.
|
|
|
|
Include the token in the `Authorization` header:
|
|
|
|
```
|
|
Authorization: Bearer YOUR_API_TOKEN
|
|
```
|
|
|
|
## Base URL
|
|
|
|
```
|
|
https://yoursite.com/api/index.php/v1/mokosuitecross/
|
|
```
|
|
|
|
## Endpoints
|
|
|
|
### Posts
|
|
|
|
| Method | Endpoint | Description |
|
|
|--------|----------|-------------|
|
|
| GET | `/v1/mokosuitecross/posts` | List all cross-posts |
|
|
| GET | `/v1/mokosuitecross/posts/:id` | Get single post details |
|
|
| POST | `/v1/mokosuitecross/posts` | Create a cross-post entry |
|
|
| DELETE | `/v1/mokosuitecross/posts/:id` | Delete a post |
|
|
|
|
### Services
|
|
|
|
| Method | Endpoint | Description |
|
|
|--------|----------|-------------|
|
|
| GET | `/v1/mokosuitecross/services` | List connected services |
|
|
| GET | `/v1/mokosuitecross/services/:id` | Get service details |
|
|
|
|
## Example
|
|
|
|
```bash
|
|
# List all posts
|
|
curl -H "Authorization: Bearer YOUR_TOKEN" \
|
|
https://yoursite.com/api/index.php/v1/mokosuitecross/posts
|
|
|
|
# List services
|
|
curl -H "Authorization: Bearer YOUR_TOKEN" \
|
|
https://yoursite.com/api/index.php/v1/mokosuitecross/services
|
|
```
|
|
|
|
## Filtering
|
|
|
|
Posts support query parameters:
|
|
- `filter[status]=posted` — Filter by status (queued, posting, posted, failed, scheduled)
|
|
- `filter[service_id]=5` — Filter by service
|
|
- `page[limit]=20` — Pagination limit
|
|
- `page[offset]=0` — Pagination offset
|