BeiträgeBeiträge auflisten
Zurück zu Sofia

Beiträge

Beiträge auflisten

Listet die Beiträge der für das Token erreichbaren Betriebe auf, neueste zuerst, filterbar nach Betrieb, Status, Zeitraum und Autor, seitenweise.

GEThttps://api.sofia-post.com/api/v1/posts
GET/v1/posts
curl -X GET 'https://api.sofia-post.com/api/v1/posts' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorisierungen

  • Authorizationstringerforderlich

    Ihr persönlicher Schlüssel oder OAuth-Access-Token, gesendet als Bearer <token>.

Abfrageparameter

  • establishmentIdstring

    Nur die Beiträge dieses Betriebs.

  • cursorstring

    Der nextCursor der vorherigen Seite.

  • statusstring

    Live: mindestens ein Netzwerk in diesem Zustand. Der status des Beitrags fasst seine Netzwerke zusammen, ein Filter auf failed kann also partial liefern.

    Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailed

  • fromstring<date-time>

    Live: mindestens ein Netzwerk ab diesem Zeitpunkt veröffentlicht (oder vor der Veröffentlichung geplant).

  • tostring<date-time>

    Live: und vor diesem Zeitpunkt (ausgeschlossen).

  • createdBystring

    Live: me für die Beiträge der Person, für die das Token handelt, app für die dieser Anwendung. Fehlt der Wert: alle.

    Zulässige Werte: meapp

  • limitnumber

    Seitengröße von 1 bis 100 (Standard 20).

Antwort

200application/json

Eine Seite Beiträge, mit nextCursor, wenn weitere folgen.

  • dataobject[]erforderlich

    Die Beiträge der Seite

    Untergeordnete Attribute anzeigen
    • idstringerforderlich

      Kennung des Beitrags

    • statusstringerforderlich

      Über alle Netzwerke; partial: auf einem veröffentlicht, auf einem anderen fehlgeschlagen

      Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailedpartial

    • establishmentIdstringerforderlich

      Betrieb des Beitrags

    • createdAtstring<date-time>erforderlich

      Wann der Beitrag erstellt wurde

    • targetsobject[]erforderlich

      Ein Eintrag pro Netzwerk und Konto: zwei Konten in einem Netzwerk, zwei Einträge

      Untergeordnete Attribute anzeigen
      • platformstringerforderlich

        Netzwerk des Ziels

      • accountIdstringerforderlich

        Das Konto, das veröffentlicht (GET /v1/establishments/:id/accounts)

      • statestringerforderlich

        Zustand des Ziels in seinem Netzwerk

        Zulässige Werte: draftscheduledpublishingpublishedsent_to_inboxfailed

      • publishedAtstring<date-time>

        Wann das Ziel veröffentlicht wurde

      • permalinkstring

        Link zum veröffentlichten Beitrag im Netzwerk

      • errorstring

        Warum das Netzwerk abgelehnt hat

    • scheduledAtstring<date-time>

      Wann der Beitrag zur Veröffentlichung geplant ist

  • nextCursorstring

    Als ?cursor= für die nächste Seite übergeben; am Ende fehlt er

400

invalid_cursor oder invalid_request bei einem fehlerhaften Parameter.

401

Das Token fehlt, ist unbekannt, abgelaufen oder widerrufen.

403

Dem Token fehlt die Berechtigung posts:read.

404

establishment_not_found: Der Betrieb ist für das Token nicht erreichbar.

4XXapplication/json

Jeder andere Fehler, im Fehlerumschlag.