Basis‑URL & Namespace

Endpunkte

POST /publish

Erstellt einen Beitrag oder eine Seite. Der HTML‑Inhalt wird als Gutenberg‑Block „Individuelles HTML“ eingefügt.

POST /wp-json/contentplanning-ai/v1/publish HTTP/1.1
Host: {WP_SITE}
Authorization: Bearer {TOKEN}
Content-Type: application/json

{
  "title": "Mein Beitrag",
  "custom_html": "
Hallo
",
  "wp_type": "post", "wp_status": "publish", "categories": [1], "headless_mode": false
}

GET /categories

Kategorien auflisten.

POST /media

Medien-Upload via multipart/form-data. Erlaubt: JPEG, PNG, GIF, WebP, SVG, AVIF. Max: 100 MB.

POST /wp-json/contentplanning-ai/v1/media HTTP/1.1
Host: {WP_SITE}
Authorization: Bearer {TOKEN}
Content-Type: multipart/form-data; boundary=----BOUNDARY

------BOUNDARY
Content-Disposition: form-data; name="file"; filename="image.jpg"
Content-Type: image/jpeg


------BOUNDARY--

GET /users

GET /status

Gibt Informationen zum Plugin und zur Umgebung zurück (Version, WordPress, PHP, charts_enabled, api_endpoint).

Authentifizierung (Details)

Authorization: Bearer <token>

{
  "api_token": "...",
  "api_password": "..."
}

Bereinigung & Sicherheit

• HTML wird mit wp_kses und Plugin‑Erweiterungen bereinigt.
• Erlaubt: <style>-Blöcke (CSS). Unicode‑Escapes und Backslashes in CSS/HTML bleiben erhalten.
• Skripte: Standardmäßig nur <script type="application/ld+json">. Externe Skripte nur von freigegebenen CDNs.
• In CSS blockiert: expression(), url(javascript:), behavior:.
• CDN‑Positivliste: contentplanning_ai_options.enable_default_cdns und contentplanning_ai_options.allowed_cdn_hosts (kommaseparierte Hosts).

Antworten & Fehler

• Erfolg: { success: true, post_id, author_id, permalink, post_type, post_status, headless_mode }
• 400 Bad Request: fehlende Felder oder ungültige Eingabe
• 413 Payload Too Large: Datei zu groß
• 415 Unsupported Media Type: ungültiger Dateityp
• 500 Server Error: WordPress‑Fehler

Beispiel‑HTTP‑Aufrufe

GET /categories (HTTP)

GET /wp-json/contentplanning-ai/v1/categories?per_page=10 HTTP/1.1
Host: {WP_SITE}
Authorization: Bearer {TOKEN}
Accept: application/json

GET /status (HTTP)

GET /wp-json/contentplanning-ai/v1/status HTTP/1.1
Host: {WP_SITE}
Authorization: Bearer {TOKEN}
Accept: application/json

Import für Postman / Insomnia

Nach dem Import bitte die Variablen baseUrl und token anpassen.

Postman Collection (v2.1)

{
  "info": {
    "name": "Contentplanning.ai Connector",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Publish",
      "request": {
        "method": "POST",
        "header": [
          { "key": "Authorization", "value": "Bearer {{token}}" },
          { "key": "Content-Type", "value": "application/json" }
        ],
        "url": { "raw": "{{baseUrl}}/wp-json/contentplanning-ai/v1/publish" },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"Mein Beitrag\",\n  \"custom_html\": \"
Hallo
\",\n  \"wp_type\": \"post\",\n  \"wp_status\": \"publish\"\n}"
        }
      }
    },
    {
      "name": "Kategorien",
      "request": {
        "method": "GET",
        "header": [ { "key": "Authorization", "value": "Bearer {{token}}" } ],
        "url": { "raw": "{{baseUrl}}/wp-json/contentplanning-ai/v1/categories?per_page=10" }
      }
    },
    {
      "name": "Status",
      "request": {
        "method": "GET",
        "header": [ { "key": "Authorization", "value": "Bearer {{token}}" } ],
        "url": { "raw": "{{baseUrl}}/wp-json/contentplanning-ai/v1/status" }
      }
    },
    {
      "name": "Medien-Upload",
      "request": {
        "method": "POST",
        "header": [ { "key": "Authorization", "value": "Bearer {{token}}" } ],
        "url": { "raw": "{{baseUrl}}/wp-json/contentplanning-ai/v1/media" },
        "body": {
          "mode": "formdata",
          "formdata": [ { "key": "file", "type": "file", "src": "image.jpg" } ]
        }
      }
    }
  ],
  "variable": [
    { "key": "baseUrl", "value": "https://example.com" },
    { "key": "token", "value": "REPLACE_ME" }
  ]
}

Insomnia (Import)

_type: export
__export_format: 4
resources:
  - _id: env_contentplanning
    _type: environment
    name: Base Env
    data:
      baseUrl: https://example.com
      token: REPLACE_ME
  - _id: fld_root
    _type: request_group
    name: Contentplanning.ai Connector
  - _id: req_publish
    _type: request
    parentId: fld_root
    name: Publish
    method: POST
    url: "{{ baseUrl }}/wp-json/contentplanning-ai/v1/publish"
    headers:
      - name: Authorization
        value: "Bearer {{ token }}"
      - name: Content-Type
        value: application/json
    body:
      mimeType: application/json
      text: |
        {
          "title": "Mein Beitrag",
          "custom_html": "
Hallo
",
          "wp_type": "post",
          "wp_status": "publish"
        }
  - _id: req_categories
    _type: request
    parentId: fld_root
    name: Kategorien
    method: GET
    url: "{{ baseUrl }}/wp-json/contentplanning-ai/v1/categories?per_page=10"
    headers:
      - name: Authorization
        value: "Bearer {{ token }}"
  - _id: req_status
    _type: request
    parentId: fld_root
    name: Status
    method: GET
    url: "{{ baseUrl }}/wp-json/contentplanning-ai/v1/status"
    headers:
      - name: Authorization
        value: "Bearer {{ token }}"
  - _id: req_media
    _type: request
    parentId: fld_root
    name: Medien-Upload
    method: POST
    url: "{{ baseUrl }}/wp-json/contentplanning-ai/v1/media"
    headers:
      - name: Authorization
        value: "Bearer {{ token }}"
    body:
      mimeType: multipart/form-data
      params:
        - name: file
          type: file
          fileName: image.jpg

Diese Seite spiegelt den aktuellen Code des Contentplanning.ai Connectors wider (Namespace contentplanning-ai/v1). Für UI‑Hinweise siehe das Benutzerhandbuch unten.