Register a WordPress Installation

Register a WordPress installation after SpaceMedia verifies a one-time challenge on the same public HTTPS host. Registration returns a public client identifier and never requires or returns a client secret.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

site_url*string

Canonical public HTTPS URL of the WordPress site.

Formaturi

redirect_uri*string

Plugin callback URL on the same host as site_url.

Formaturi

challenge*string

One-time verification value exposed by challenge_url.

Length64 <= length <= 64

challenge_url*string

Public plugin verification endpoint on the same host.

Formaturi

plugin_version?|

Lengthlength <= 30

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/integrations/wordpress/oauth/register" \  -H "Content-Type: application/json" \  -d '{    "site_url": "https://music.example.invalid",    "redirect_uri": "https://music.example.invalid/wp-admin/admin-post.php?action=spacemedia_oauth_callback",    "challenge": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",    "challenge_url": "https://music.example.invalid/wp-json/spacemedia/v1/oauth/challenge",    "plugin_version": "1.0.0"  }'

{  "client_id": "docs_wordpress_client",  "authorization_endpoint": "https://staging.spacemedia.uk/api/v1/integrations/wordpress/oauth/authorize",  "token_endpoint": "https://staging.spacemedia.uk/api/v1/integrations/wordpress/oauth/token",  "catalog_endpoint": "https://staging.spacemedia.uk/api/v1/integrations/wordpress/oauth/catalog",  "revoke_endpoint": "https://staging.spacemedia.uk/api/v1/integrations/wordpress/oauth/revoke"}

Request Body

Response Body

201application/json

422application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`