DEV.to: posztolási szabályok és beállítások
Mit fogad el a DEV.to csatorna a Postyban: média, korlátok, kötelező mezők, és a settings objektum mezői az API-hoz.
Alapadatok
devtoBejegyzéstípusok
Ugyanaz a csatorna többféle alakú bejegyzést fogad el, és mindegyik mást követel meg. A táblázatból kiderül, melyikhez mi kell.
| Típus | Média | Megjegyzés |
|---|---|---|
| Cikk | borítókép a main_image mezőben | A cím kötelező. A bejegyzéshez csatolt képeket nem küldi el. |
Szabályok
- A bekötés egy DEV API kulccsal megy. A kulcsot a DEV beállításaidban készíted el.
- A cikk az ütemezett időpontban jelenik meg, Markdown formában.
- A címkék és a szervezet a DEV-ről származó értékeket várnak. A listákat a csatorna eszközhívásaival kéred le.
Beállításmezők
Ezek a mezők a bejegyzés settings objektumába kerülnek, a __type mező mellé. A felületen ugyanezeket a csatorna lenyíló beállításszakaszában töltöd ki.
| Mező | Típus | Kötelező | Mit csinál |
|---|---|---|---|
| title | string, legalább 2 karakter | igen | A cikk címe. |
| main_image | médiaobjektum | nem | A borítókép a médiatárból. |
| tags | tömb, minden elem { value: number, label: string }, legfeljebb 4 | nem | A cikk címkéi. Alapértelmezés: üres lista. |
| canonical | string (URL) | nem | Az eredeti cikk URL-je, ha előbb máshol jelent meg. |
| organization | string (azonosító) | nem | Annak a szervezetnek az azonosítója, amelynek a neve alatt megjelenik. |
Példák
Minden példa egy elem a POST /public/v1/posts kérés posts tömbjében. A körülötte lévő boríték minden esetben ez:
{
"type": "schedule",
"date": "2026-09-15T09:00:00.000Z",
"shortLink": false,
"posts": [ /* az alábbi elem */ ]
}Cikk címkékkel és borítóképpel
A címkék értékeit a csatorna tags eszközhívása adja. A Posty a labelt küldi el.
{
"integration": { "id": "<devto-csatorna>" },
"value": [{ "content": "<p>Így feleztük meg a build időt.</p>", "image": [] }],
"settings": {
"__type": "devto",
"title": "Így feleztük meg a build időt",
"main_image": { "id": "<media>", "path": "https://uploads.posty.hu/cover.png" },
"tags": [
{ "value": 1, "label": "javascript" },
{ "value": 2, "label": "webdev" }
],
"canonical": "https://example.com/blog/build-time"
}
}A csatorna azonosítóját a csatornalista adja, a képek és videók path értékét pedig a médiafeltöltés. A bekötött fiókra érvényes, pontos sémát a beállítássémát visszaadó végpont adja vissza. Parancssorból ugyanez a --settings kapcsolóval megy, lásd a CLI-példákat.