Minden API-végpont
A nyilvános REST API teljes végpontlistája metódussal, útvonallal és a hozzá szükséges jogosultsággal.
Die vollständige Liste
Jeder Pfad liegt unter https://api.posty.hu/public/v1. Klicke auf den Namen für die ausführliche Beschreibung, mit den Parametern und einem lauffähigen Beispiel.
| Methode | Pfad | Was es tut | Berechtigung |
|---|---|---|---|
| GET | /status | Állapot és felderítés. Az egyetlen útvonal, amely kulcs nélkül is válaszol. | — |
| GET | /is-connected | Ellenőrzi, hogy a kulcs érvényes munkaterületre mutat-e. | — |
| GET | /integrations | A bekötött csatornák: azonosító, név, @handle, platform, és hogy tud-e most posztolni. | channels:read |
| GET | /integration-settings/:id | Egy csatorna posztolási szabályai és beállítássémája, a fiókra feloldott karakterkorláttal. | channels:read |
| POST | /integration-trigger/:id | Platformspecifikus lekérdezés egy csatornán: táblák, subredditek, oldalak listája. | channels:read |
| GET | /social/:integration | Visszaadja azt a platformcímet, amit egy embernek meg kell nyitnia a csatorna bekötéséhez. | channels:write |
| GET | /groups | Az ügyfélcsoportok, amelyekbe a csatornák be vannak sorolva. | channels:read |
| GET | /posts | A naptár egy időszakra: minden poszt állapottal és időponttal. | posts:read |
| POST | /posts | Poszt létrehozása: piszkozat, ütemezés vagy azonnali közzététel, egy vagy több csatornára. | posts:draft (közzétételhez posts:publish is) |
| DELETE | /posts/:id | Egy poszt törlése és a hozzá tartozó folyamat leállítása. | posts:draft |
| DELETE | /posts/group/:group | A teljes csoport törlése: egy szerkesztés, ami több csatornára ment ki, egyetlen posztnak számít. | posts:draft |
| PUT | /posts/:id/status | Poszt átmozgatása piszkozat és ütemezett állapot között. | posts:publish |
| GET | /posts/:id/missing | Megmondja, mi hiányzik még a poszthoz a közzétételhez. | posts:read |
| PUT | /posts/:id/release-id | A platformon kívül közzétett poszt azonosítójának és címének rögzítése. | posts:publish |
| GET | /find-slot/:id | A következő szabad időpont a munkaterület ütemezése szerint. | posts:read |
| POST | /upload | Kép vagy videó feltöltése a médiatárba, legfeljebb 1 GB. | media:write |
| POST | /upload-from-url | Médiafájl behúzása nyilvános URL-ről a médiatárba. | media:write |
| POST | /upload-link | Böngészős feltöltési link, ha a fájl a felhasználó eszközén van. | media:write |
| GET | /upload-link/:id | A feltöltési linken beérkezett fájlok, a posztba tehető címmel. | media:write |
| GET | /analytics/:integration | Egy csatorna statisztikái a kért időszakra. | analytics:read |
| GET | /analytics/post/:postId | Egy közzétett poszt platformstatisztikái. | analytics:read |
| GET | /notifications | A munkaterület értesítései, lapozva. | posts:read |
So liest du sie
Die Spalte „Berechtigung“ zeigt, welchen Scope der Schlüssel braucht. Fehlt er, ist die Antwort 403. Sie nennt den fehlenden Scope und die aktuelle Rolle des Schlüsselinhabers. Die Liste der Scopes findest du auf der Seite Authentifizierung.
Zwei Pfade, /status und /is-connected, brauchen keinen Scope. Der erste braucht auch keine Authentifizierung.
Die genauen Schemas
Diese Seiten beschreiben die Nutzung mit Beispielen. Das maschinenlesbare Schema, Feld für Feld, steht im OpenAPI-3-Dokument, und daraus kannst du auch Clientcode generieren lassen.
Fehlerantworten und Aufruflimits stehen auf der Seite Fehler und Limits.