Blog

Endpointy „Blog” Zanfia Workspace API — ze schematami i przykładami kodu.

6 min czytaniaOstatnia aktualizacja: 23 paź 2026

Blog konta (Twoja strona → Blog): wpisy w Markdown serwowane pod /blog/{slug} w domenie Twojego sklepu, z kanałem RSS pod /blog/feed. Wpis powstaje jako szkic widoczny tylko dla zespołu i staje się publiczny po wywołaniu endpointu publikacji (od razu) albo planowania (o wybranej porze; scheduledAt: null cofa go do szkicu). Publikacja wymaga treści (inaczej 400), a podany slug musi być wolny (409). Kategorie grupują wpisy: każdy wpis należy do najwyżej 3 z nich (categoryIds); usunięcie kategorii zdejmuje ją z wpisów, a same wpisy zostają bez zmian. Odczyt wymaga scope’u pages:read, każdy zapis pages:write. Wszystkie endpointy wymagają nagłówka Authorization: Bearer — zobacz Uwierzytelnianie.

Lista wpisów na blogu

GET/blog-posts

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Response Body

`application/json`

curl -X GET "https://example.com/blog-posts"

{  "count": 0,  "posts": [    {      "id": "string",      "slug": "string",      "title": "string",      "excerpt": "string",      "coverImageUrl": "string",      "tags": [        "string"      ],      "status": "draft",      "publishedAt": "string",      "scheduledAt": "string",      "categoryIds": [        "string"      ],      "createdAt": "string",      "updatedAt": "string"    }  ]}

{  "error": "string",  "message": "string"}

Utwórz wpis na blogu

POST/blog-posts

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title*string

slug?string

Derived from the title when omitted; a taken derived slug gets a numeric suffix.

content?string

Markdown body; a draft may start empty.

excerpt?string

coverImageUrl?string

tags?array<string>

seo?

publish?boolean

Publish right away (needs a non-empty body); defaults to false (draft).

publishedAt?string

ISO 8601 date (2025-10-16) or date-time, not in the future: the post's date (an imported post keeps its original one). Omitted = the moment of the first publication.

categoryIds?array<string>

Category ids (list-blog-categories), at most 3.

Response Body

`application/json`

curl -X POST "https://example.com/blog-posts" \  -H "Content-Type: application/json" \  -d '{    "title": "string"  }'

{  "id": "string",  "slug": "string",  "title": "string",  "excerpt": "string",  "coverImageUrl": "string",  "tags": [    "string"  ],  "status": "draft",  "publishedAt": "string",  "scheduledAt": "string",  "categoryIds": [    "string"  ],  "createdAt": "string",  "updatedAt": "string",  "content": "string",  "seo": {    "title": "string",    "description": "string",    "noindex": true  }}

{  "error": "string",  "message": "string"}

Szczegóły wpisu na blogu

GET/blog-posts/{postId}

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Path Parameters

postId*string

Response Body

`application/json`

curl -X GET "https://example.com/blog-posts/string"

{  "id": "string",  "slug": "string",  "title": "string",  "excerpt": "string",  "coverImageUrl": "string",  "tags": [    "string"  ],  "status": "draft",  "publishedAt": "string",  "scheduledAt": "string",  "categoryIds": [    "string"  ],  "createdAt": "string",  "updatedAt": "string",  "content": "string",  "seo": {    "title": "string",    "description": "string",    "noindex": true  }}

{  "error": "string",  "message": "string"}

Zmień wpis na blogu

PATCH/blog-posts/{postId}

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Path Parameters

postId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

title?string

slug?string

content?string

excerpt?string

coverImageUrl?|

null removes the cover.

tags?array<string>

seo?

Replaces the whole SEO section.

publishedAt?|

ISO 8601, not in the future; null clears the date of a draft (a published post keeps one).

categoryIds?array<string>

Replaces the post's categories (ids from list-blog-categories, at most 3; [] = none).

Response Body

`application/json`

curl -X PATCH "https://example.com/blog-posts/string" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "string",  "slug": "string",  "title": "string",  "excerpt": "string",  "coverImageUrl": "string",  "tags": [    "string"  ],  "status": "draft",  "publishedAt": "string",  "scheduledAt": "string",  "categoryIds": [    "string"  ],  "createdAt": "string",  "updatedAt": "string",  "content": "string",  "seo": {    "title": "string",    "description": "string",    "noindex": true  }}

{  "error": "string",  "message": "string"}

Usuń wpis z bloga

DELETE/blog-posts/{postId}

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Path Parameters

postId*string

Response Body

`application/json`

curl -X DELETE "https://example.com/blog-posts/string"

{  "postId": "string"}

{  "error": "string",  "message": "string"}

Opublikuj lub cofnij publikację wpisu

POST/blog-posts/{postId}/publish

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Path Parameters

postId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

publish*boolean

false = back to draft.

Response Body

`application/json`

curl -X POST "https://example.com/blog-posts/string/publish" \  -H "Content-Type: application/json" \  -d '{    "publish": true  }'

{  "id": "string",  "slug": "string",  "title": "string",  "excerpt": "string",  "coverImageUrl": "string",  "tags": [    "string"  ],  "status": "draft",  "publishedAt": "string",  "scheduledAt": "string",  "categoryIds": [    "string"  ],  "createdAt": "string",  "updatedAt": "string",  "content": "string",  "seo": {    "title": "string",    "description": "string",    "noindex": true  }}

{  "error": "string",  "message": "string"}

Zaplanuj publikację wpisu

POST/blog-posts/{postId}/schedule

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Path Parameters

postId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

scheduledAt*|

ISO 8601 date-time with an offset (2026-10-20T08:00:00+02:00): when the post goes live, at least a minute and at most a year ahead. null = unschedule (back to draft).

Response Body

`application/json`

curl -X POST "https://example.com/blog-posts/string/schedule" \  -H "Content-Type: application/json" \  -d '{    "scheduledAt": "string"  }'

{  "id": "string",  "slug": "string",  "title": "string",  "excerpt": "string",  "coverImageUrl": "string",  "tags": [    "string"  ],  "status": "draft",  "publishedAt": "string",  "scheduledAt": "string",  "categoryIds": [    "string"  ],  "createdAt": "string",  "updatedAt": "string",  "content": "string",  "seo": {    "title": "string",    "description": "string",    "noindex": true  }}

{  "error": "string",  "message": "string"}

Lista kategorii bloga

GET/blog-categories

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Response Body

`application/json`

curl -X GET "https://example.com/blog-categories"

{  "count": 0,  "categories": [    {      "id": "string",      "name": "string",      "slug": "string",      "description": "string",      "seo": {        "title": "string",        "description": "string"      },      "postCount": 0,      "createdAt": "string",      "updatedAt": "string"    }  ]}

{  "error": "string",  "message": "string"}

Utwórz kategorię bloga

POST/blog-categories

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

slug?string

Derived from the name when omitted.

description?string

seo?

Response Body

`application/json`

curl -X POST "https://example.com/blog-categories" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'

{  "id": "string",  "name": "string",  "slug": "string",  "description": "string",  "seo": {    "title": "string",    "description": "string"  },  "postCount": 0,  "createdAt": "string",  "updatedAt": "string"}

{  "error": "string",  "message": "string"}

Zmień kategorię bloga

PATCH/blog-categories/{categoryId}

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Path Parameters

categoryId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name?string

slug?string

description?string

seo?

Replaces the whole SEO section.

Response Body

`application/json`

curl -X PATCH "https://example.com/blog-categories/string" \  -H "Content-Type: application/json" \  -d '{}'

{  "id": "string",  "name": "string",  "slug": "string",  "description": "string",  "seo": {    "title": "string",    "description": "string"  },  "postCount": 0,  "createdAt": "string",  "updatedAt": "string"}

{  "error": "string",  "message": "string"}

Usuń kategorię bloga

DELETE/blog-categories/{categoryId}

Authorization

bearerAuth

AuthorizationBearer <token>

API key from Dashboard → Integrations → API, MCP and CLI.

In: header

Path Parameters

categoryId*string

Response Body

`application/json`

curl -X DELETE "https://example.com/blog-categories/string"

{  "categoryId": "string"}

{  "error": "string",  "message": "string"}

Czy ten artykuł był pomocny?

Powiązane artykuły

Coś się nie zgadza? Napisz do nas na support@zanfia.com.

Lista wpisów na blogu

200application/json

4XXapplication/json

Utwórz wpis na blogu

201application/json

4XXapplication/json

Szczegóły wpisu na blogu

200application/json

4XXapplication/json

Zmień wpis na blogu

200application/json

4XXapplication/json

Usuń wpis z bloga

200application/json

4XXapplication/json

Opublikuj lub cofnij publikację wpisu

200application/json

4XXapplication/json

Zaplanuj publikację wpisu

200application/json

4XXapplication/json

Lista kategorii bloga

200application/json

4XXapplication/json

Utwórz kategorię bloga

201application/json

4XXapplication/json

Zmień kategorię bloga

200application/json

4XXapplication/json

Usuń kategorię bloga

200application/json

4XXapplication/json

Powiązane artykuły

Przegląd API

Uwierzytelnianie i klucze API

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`