REST APIPOST

Massenplanung prüfen

Testlauf für eine Massenplanung: Senden Sie denselben Body wie bei Massenplanung und erhalten Sie einen Bericht pro Beitrag, in der Reihenfolge der Anfrage, ohne dass ein Beitrag angelegt wird.

POSThttps://post.adaptlypost.com/post/api/v1/social-posts/bulk/validate

Prüft eine ganze Massenplanung, ohne einen Beitrag anzulegen. Senden Sie denselben Body wie bei Massenplanung und erhalten Sie einen Bericht pro Beitrag, in der Reihenfolge der Anfrage.

API-Schlüssel (Bearer-Token)
Berechtigung:posts.draftRollen und Berechtigungen

Für die Prüfung genügt posts.draft. requiredPermissions in jedem Bericht nennt, was das Planen dieses Beitrags bräuchte.

Request-Body

Derselbe Body wie bei Massenplanung, mit bis zu 100 Beiträgen. Konfigurationen auf Batch-Ebene gelten für jeden Beitrag und Konfigurationen pro Beitrag überschreiben sie, genau wie beim Planen. Es wird nichts angelegt oder gespeichert.

Antwortfelder

FeldBeschreibung
validNur true, wenn jeder Beitrag gültig ist
totalValidWie viele Beiträge kein ERROR-Problem haben
totalInvalidWie viele Beiträge mindestens ein ERROR-Problem haben
resultsEin Eintrag pro Beitrag als { index, report }. index ist die Position des Beitrags in posts, beginnend bei 0. report hat dieselben Felder wie die Antwort von Beitrag prüfen

Vor dem Planen prüfen

Massenplanung plant jeden gültigen Beitrag, auch wenn andere fehlschlagen. Beheben Sie zuerst die Beiträge, deren Bericht nicht gültig ist, dann geht der ganze Batch wie geplant raus.
Eine Massenplanung prüfen
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/social-posts/bulk/validate \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "platforms": ["TWITTER"],
    "timezone": "America/New_York",
    "twitterConnectionIds": ["conn_abc123"],
    "posts": [
      {
        "contentType": "TEXT",
        "text": "Tip of the week: batch your posts on Mondays.",
        "scheduledAt": "2026-11-02T14:00:00Z"
      },
      {
        "contentType": "TEXT",
        "text": "<a 320-character announcement>",
        "scheduledAt": "2026-11-04T14:00:00Z"
      }
    ]
  }'
200
{
  "valid": false,
  "totalValid": 1,
  "totalInvalid": 1,
  "results": [
    {
      "index": 0,
      "report": {
        "valid": true,
        "outcome": "SCHEDULED",
        "scheduledAt": "2026-11-02T14:00:00.000Z",
        "requiredPermissions": ["posts.schedule"],
        "issues": [],
        "accounts": [
          {
            "platform": "TWITTER",
            "connectionId": "conn_abc123",
            "accountName": "@yourhandle",
            "status": "READY",
            "issues": []
          }
        ],
        "notChecked": []
      }
    },
    {
      "index": 1,
      "report": {
        "valid": false,
        "outcome": "SCHEDULED",
        "scheduledAt": "2026-11-04T14:00:00.000Z",
        "requiredPermissions": ["posts.schedule"],
        "issues": [],
        "accounts": [
          {
            "platform": "TWITTER",
            "connectionId": "conn_abc123",
            "accountName": "@yourhandle",
            "status": "BLOCKED",
            "issues": [
              {
                "code": "TEXT_TOO_LONG",
                "severity": "ERROR",
                "message": "Text exceeds maximum length for Twitter/X. Maximum is 280 characters",
                "platform": "TWITTER",
                "connectionId": "conn_abc123"
              }
            ]
          }
        ],
        "notChecked": []
      }
    }
  ]
}