Fresh start - excluded large ROM JSON files

skills/api-gateway/references/wordpress.md

@@ -0,0 +1,168 @@
+# WordPress.com Routing Reference
+
+**App name:** `wordpress`
+**Base URL proxied:** `public-api.wordpress.com`
+
+## API Path Pattern
+
+```
+/wordpress/rest/v1.1/{endpoint}
+```
+
+**Important:** WordPress.com uses REST API v1.1. Site-specific endpoints use `/sites/{site_id_or_domain}/{resource}`.
+
+## Site Identifiers
+
+Sites can be identified by:
+- Numeric site ID (e.g., `252505333`)
+- Domain name (e.g., `myblog.wordpress.com`)
+
+## Common Endpoints
+
+### Sites
+
+#### Get Site Information
+```bash
+GET /wordpress/rest/v1.1/sites/{site}
+```
+
+### Posts
+
+#### List Posts
+```bash
+GET /wordpress/rest/v1.1/sites/{site}/posts
+```
+
+Query parameters: `number`, `offset`, `page_handle`, `status`, `search`, `category`, `tag`, `author`
+
+#### Get Post
+```bash
+GET /wordpress/rest/v1.1/sites/{site}/posts/{post_id}
+```
+
+#### Create Post
+```bash
+POST /wordpress/rest/v1.1/sites/{site}/posts/new
+Content-Type: application/json
+
+{
+  "title": "Post Title",
+  "content": "<p>Post content...</p>",
+  "status": "draft",
+  "categories": "news",
+  "tags": "featured"
+}
+```
+
+#### Update Post
+```bash
+POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}
+Content-Type: application/json
+
+{
+  "title": "Updated Title",
+  "content": "<p>Updated content...</p>"
+}
+```
+
+#### Delete Post
+```bash
+POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/delete
+```
+
+### Pages
+
+#### List Pages
+```bash
+GET /wordpress/rest/v1.1/sites/{site}/posts?type=page
+```
+
+#### Create Page
+```bash
+POST /wordpress/rest/v1.1/sites/{site}/posts/new?type=page
+Content-Type: application/json
+
+{
+  "title": "Page Title",
+  "content": "<p>Page content...</p>",
+  "status": "publish"
+}
+```
+
+### Post Likes
+
+#### Get Post Likes
+```bash
+GET /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/likes
+```
+
+#### Like Post
+```bash
+POST /wordpress/rest/v1.1/sites/{site}/posts/{post_id}/likes/new
+```
+
+### Users
+
+#### List Site Users
+```bash
+GET /wordpress/rest/v1.1/sites/{site}/users
+```
+
+### User Settings
+
+#### Get My Settings
+```bash
+GET /wordpress/rest/v1.1/me/settings
+```
+
+#### Update My Settings
+```bash
+POST /wordpress/rest/v1.1/me/settings/
+Content-Type: application/json
+
+{
+  "enable_translator": false
+}
+```
+
+### Post Types
+
+#### List Post Types
+```bash
+GET /wordpress/rest/v1.1/sites/{site}/post-types
+```
+
+### Post Counts
+
+#### Get Post Counts
+```bash
+GET /wordpress/rest/v1.1/sites/{site}/post-counts/{post_type}
+```
+
+## Pagination
+
+WordPress.com uses cursor-based pagination with `page_handle`:
+
+```bash
+GET /wordpress/rest/v1.1/sites/{site}/posts?number=20
+# Response includes "meta": {"next_page": "..."}
+
+GET /wordpress/rest/v1.1/sites/{site}/posts?number=20&page_handle={next_page}
+```
+
+Alternatively, use `offset` for simple pagination.
+
+## Notes
+
+- API version is v1.1 (not v2)
+- POST is used for updates (not PUT/PATCH)
+- POST to `/delete` endpoint is used for deletes (not HTTP DELETE)
+- Categories and tags are created automatically when referenced in posts
+- Content is HTML-formatted
+- Date/time values are in ISO 8601 format
+
+## Resources
+
+- [WordPress.com REST API Overview](https://developer.wordpress.com/docs/api/)
+- [Getting Started Guide](https://developer.wordpress.com/docs/api/getting-started/)
+- [API Reference](https://developer.wordpress.com/docs/api/rest-api-reference/)