{ "openapi": "3.1.0", "x-powered-by": "custom-strapi-public-openapi", "info": { "title": "toPrawdziwe.pl Public API", "description": "Public content API documentation for api.toprawdziwe.pl. Use the `Authorize` action with a bearer API token. Administrative, plugin, and private endpoints are intentionally excluded.", "version": "0.1.0" }, "servers": [ { "url": "https://api.toprawdziwe.pl" } ], "tags": [ { "name": "BlogPost", "description": "Knowledge base article" }, { "name": "Kategoria", "description": "Drzewo kategorii sklepow i tresci" }, { "name": "Produkt", "description": "Produkt sklepu; moze byc oznaczony jako polecany" }, { "name": "Sklep", "description": "Glowny profil sklepu lub marki" }, { "name": "Tag", "description": "Tagi filtrow sklepow" } ], "paths": { "/api/blog-posts": { "get": { "tags": [ "BlogPost" ], "operationId": "public/get/blog-posts", "summary": "List BlogPost", "description": "Knowledge base article", "parameters": [ { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Sort by a single field using `field:asc` or `field:desc`.", "example": "publishedAt:desc" }, { "name": "sort[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First sort instruction when passing multiple sort values.", "example": "priorytetSortowania:asc" }, { "name": "filters[field][$eq]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by exact match. Replace `field` with a real field name.", "example": "true" }, { "name": "filters[field][$in][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First value for an `$in` filter. Replace `field` with a real field name.", "example": "manufaktura" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" }, { "name": "pagination[page]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Page number for page-based pagination.", "example": 1 }, { "name": "pagination[pageSize]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents per page.", "example": 10 }, { "name": "pagination[start]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Offset for offset-based pagination.", "example": 0 }, { "name": "pagination[limit]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents to return for offset-based pagination.", "example": 10 } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/BlogPostDocument" } }, "meta": { "$ref": "#/components/schemas/CollectionMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/blog-posts/{documentId}": { "get": { "tags": [ "BlogPost" ], "operationId": "public/get/blog-post_by_document_id", "summary": "Get BlogPost", "description": "Knowledge base article", "parameters": [ { "name": "documentId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stable document identifier used by Strapi 5 content API." }, { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/BlogPostDocument" }, "meta": { "$ref": "#/components/schemas/SingleMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/categories": { "get": { "tags": [ "Kategoria" ], "operationId": "public/get/categories", "summary": "List Kategoria", "description": "Drzewo kategorii sklepow i tresci", "parameters": [ { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Sort by a single field using `field:asc` or `field:desc`.", "example": "publishedAt:desc" }, { "name": "sort[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First sort instruction when passing multiple sort values.", "example": "priorytetSortowania:asc" }, { "name": "filters[field][$eq]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by exact match. Replace `field` with a real field name.", "example": "true" }, { "name": "filters[field][$in][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First value for an `$in` filter. Replace `field` with a real field name.", "example": "manufaktura" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" }, { "name": "pagination[page]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Page number for page-based pagination.", "example": 1 }, { "name": "pagination[pageSize]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents per page.", "example": 10 }, { "name": "pagination[start]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Offset for offset-based pagination.", "example": 0 }, { "name": "pagination[limit]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents to return for offset-based pagination.", "example": 10 } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryDocument" } }, "meta": { "$ref": "#/components/schemas/CollectionMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/categories/{documentId}": { "get": { "tags": [ "Kategoria" ], "operationId": "public/get/category_by_document_id", "summary": "Get Kategoria", "description": "Drzewo kategorii sklepow i tresci", "parameters": [ { "name": "documentId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stable document identifier used by Strapi 5 content API." }, { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CategoryDocument" }, "meta": { "$ref": "#/components/schemas/SingleMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/produkty": { "get": { "tags": [ "Produkt" ], "operationId": "public/get/produkty", "summary": "List Produkt", "description": "Produkt sklepu; moze byc oznaczony jako polecany", "parameters": [ { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Sort by a single field using `field:asc` or `field:desc`.", "example": "publishedAt:desc" }, { "name": "sort[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First sort instruction when passing multiple sort values.", "example": "priorytetSortowania:asc" }, { "name": "filters[field][$eq]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by exact match. Replace `field` with a real field name.", "example": "true" }, { "name": "filters[field][$in][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First value for an `$in` filter. Replace `field` with a real field name.", "example": "manufaktura" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" }, { "name": "pagination[page]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Page number for page-based pagination.", "example": 1 }, { "name": "pagination[pageSize]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents per page.", "example": 10 }, { "name": "pagination[start]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Offset for offset-based pagination.", "example": 0 }, { "name": "pagination[limit]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents to return for offset-based pagination.", "example": 10 } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ProduktDocument" } }, "meta": { "$ref": "#/components/schemas/CollectionMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/produkty/{documentId}": { "get": { "tags": [ "Produkt" ], "operationId": "public/get/produkt_by_document_id", "summary": "Get Produkt", "description": "Produkt sklepu; moze byc oznaczony jako polecany", "parameters": [ { "name": "documentId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stable document identifier used by Strapi 5 content API." }, { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ProduktDocument" }, "meta": { "$ref": "#/components/schemas/SingleMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/stores": { "get": { "tags": [ "Sklep" ], "operationId": "public/get/stores", "summary": "List Sklep", "description": "Glowny profil sklepu lub marki", "parameters": [ { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Sort by a single field using `field:asc` or `field:desc`.", "example": "publishedAt:desc" }, { "name": "sort[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First sort instruction when passing multiple sort values.", "example": "priorytetSortowania:asc" }, { "name": "filters[field][$eq]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by exact match. Replace `field` with a real field name.", "example": "true" }, { "name": "filters[field][$in][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First value for an `$in` filter. Replace `field` with a real field name.", "example": "manufaktura" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" }, { "name": "pagination[page]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Page number for page-based pagination.", "example": 1 }, { "name": "pagination[pageSize]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents per page.", "example": 10 }, { "name": "pagination[start]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Offset for offset-based pagination.", "example": 0 }, { "name": "pagination[limit]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents to return for offset-based pagination.", "example": 10 } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/StoreDocument" } }, "meta": { "$ref": "#/components/schemas/CollectionMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/stores/{documentId}": { "get": { "tags": [ "Sklep" ], "operationId": "public/get/store_by_document_id", "summary": "Get Sklep", "description": "Glowny profil sklepu lub marki", "parameters": [ { "name": "documentId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stable document identifier used by Strapi 5 content API." }, { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/StoreDocument" }, "meta": { "$ref": "#/components/schemas/SingleMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/tags": { "get": { "tags": [ "Tag" ], "operationId": "public/get/tags", "summary": "List Tag", "description": "Tagi filtrow sklepow", "parameters": [ { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Sort by a single field using `field:asc` or `field:desc`.", "example": "publishedAt:desc" }, { "name": "sort[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First sort instruction when passing multiple sort values.", "example": "priorytetSortowania:asc" }, { "name": "filters[field][$eq]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Filter by exact match. Replace `field` with a real field name.", "example": "true" }, { "name": "filters[field][$in][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First value for an `$in` filter. Replace `field` with a real field name.", "example": "manufaktura" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" }, { "name": "pagination[page]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Page number for page-based pagination.", "example": 1 }, { "name": "pagination[pageSize]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents per page.", "example": 10 }, { "name": "pagination[start]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Offset for offset-based pagination.", "example": 0 }, { "name": "pagination[limit]", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1 }, "description": "Number of documents to return for offset-based pagination.", "example": 10 } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/TagDocument" } }, "meta": { "$ref": "#/components/schemas/CollectionMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/api/tags/{documentId}": { "get": { "tags": [ "Tag" ], "operationId": "public/get/tag_by_document_id", "summary": "Get Tag", "description": "Tagi filtrow sklepow", "parameters": [ { "name": "documentId", "in": "path", "required": true, "schema": { "type": "string" }, "description": "Stable document identifier used by Strapi 5 content API." }, { "name": "fields[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "First top-level field to return.", "example": "slug" }, { "name": "fields[1]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Second top-level field to return.", "example": "nazwaSklepu" }, { "name": "populate", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "*" ] }, "description": "Populate every relation, media field, and component one level deep.", "example": "*" }, { "name": "populate[0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate a single relation, media field, or component.", "example": "kategorie" }, { "name": "populate[relation][populate][0]", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Populate one nested field below a populated relation or component.", "example": "rodzic" }, { "name": "locale", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Locale code when internationalization is enabled.", "example": "pl" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "enum": [ "published", "draft" ] }, "description": "Publication state to query.", "example": "published" } ], "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/TagDocument" }, "meta": { "$ref": "#/components/schemas/SingleMeta" } }, "required": [ "data", "meta" ] } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "Internal server error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "schemas": { "Error": { "type": "object", "properties": { "data": { "anyOf": [ { "type": "null" }, { "type": "object" }, { "type": "array" } ] }, "error": { "type": "object", "properties": { "status": { "type": "integer" }, "name": { "type": "string" }, "message": { "type": "string" }, "details": { "type": "object", "additionalProperties": true } }, "required": [ "status", "name", "message" ] } }, "required": [ "error" ] }, "Pagination": { "type": "object", "properties": { "page": { "type": "integer", "minimum": 1 }, "pageSize": { "type": "integer", "minimum": 1 }, "pageCount": { "type": "integer", "minimum": 0 }, "total": { "type": "integer", "minimum": 0 } }, "required": [ "page", "pageSize", "pageCount", "total" ] }, "CollectionMeta": { "type": "object", "properties": { "pagination": { "$ref": "#/components/schemas/Pagination" } }, "required": [ "pagination" ] }, "SingleMeta": { "type": "object", "additionalProperties": true, "description": "Additional metadata returned by Strapi for a single document response." }, "UploadFile": { "type": "object", "description": "Media object returned when a media field is populated.", "properties": { "id": { "type": "integer" }, "documentId": { "type": "string" }, "name": { "type": "string" }, "alternativeText": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "caption": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "width": { "type": "integer" }, "height": { "type": "integer" }, "formats": { "type": "object", "additionalProperties": true }, "hash": { "type": "string" }, "ext": { "type": "string" }, "mime": { "type": "string" }, "size": { "type": "number" }, "url": { "type": "string" }, "previewUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "provider": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "documentId", "name", "hash", "mime", "size", "url", "provider", "createdAt", "updatedAt" ] }, "KontaktLokalizacjaStacjonarnaComponent": { "type": "object", "description": "Adres i wspolrzedne punktu stacjonarnego Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "ulica": { "type": "string" }, "miasto": { "type": "string" }, "wojewodztwo": { "type": "string", "enum": [ "dolnośląskie", "kujawsko-pomorskie", "lubelskie", "lubuskie", "łódzkie", "małopolskie", "mazowieckie", "opolskie", "podkarpackie", "podlaskie", "pomorskie", "śląskie", "świętokrzyskie", "warmińsko-mazurskie", "wielkopolskie", "zachodniopomorskie" ] }, "kodPocztowy": { "type": "string" }, "linkGoogleMaps": { "type": "string" }, "latitude": { "type": "number" }, "longitude": { "type": "number" } }, "required": [ "id", "miasto", "wojewodztwo" ], "additionalProperties": false }, "KontaktSocialMediaComponent": { "type": "object", "description": "Linki do profilow social media sklepu Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "instagramUrl": { "type": "string" }, "facebookUrl": { "type": "string" }, "youTubeUrl": { "type": "string" } }, "required": [ "id" ], "additionalProperties": false }, "SekcjeFilarPrawdziwosciComponent": { "type": "object", "description": "Redakcyjny filar potwierdzajacy autentycznosc sklepu Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "tytul": { "type": "string" }, "opis": { "type": "string" } }, "required": [ "id", "tytul", "opis" ], "additionalProperties": false }, "SprzedazKodRabatowyComponent": { "type": "object", "description": "Kod znizkowy lub korzysc promocyjna sklepu Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "kod": { "type": "string" }, "wartosc": { "type": "string" }, "opis": { "type": "string" }, "dataWaznosci": { "type": "string", "format": "date" } }, "required": [ "id", "kod", "wartosc" ], "additionalProperties": false }, "BlogPostDocument": { "type": "object", "description": "Knowledge base article Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "documentId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "publishedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "title": { "type": "string" }, "slug": { "type": "string" }, "content": { "type": "string" }, "zajawka": { "type": "string" }, "autor": { "type": "string" }, "coverImage": { "allOf": [ { "$ref": "#/components/schemas/UploadFile" } ], "description": "Returned when the field is populated." }, "publicationDate": { "type": "string", "format": "date-time" }, "categories": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryDocument" }, "description": "Returned when the field is populated." }, "metaTitle": { "type": "string" }, "metaDescription": { "type": "string" } }, "required": [ "id", "documentId", "createdAt", "updatedAt", "publishedAt", "title", "slug" ], "additionalProperties": false }, "CategoryDocument": { "type": "object", "description": "Drzewo kategorii sklepow i tresci Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "documentId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "publishedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "nazwa": { "type": "string" }, "slug": { "type": "string" }, "opisKrotki": { "type": "string" }, "opisDlugiSeo": { "type": "string" }, "metaTitle": { "type": "string" }, "metaDescription": { "type": "string" }, "ikona": { "type": "string" }, "zdjecieGlowne": { "allOf": [ { "$ref": "#/components/schemas/UploadFile" } ], "description": "Returned when the field is populated." }, "rodzic": { "allOf": [ { "$ref": "#/components/schemas/CategoryDocument" } ], "description": "Returned when the field is populated." }, "dzieci": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryDocument" }, "description": "Returned when the field is populated." } }, "required": [ "id", "documentId", "createdAt", "updatedAt", "publishedAt", "nazwa", "slug" ], "additionalProperties": false }, "ProduktDocument": { "type": "object", "description": "Produkt sklepu; moze byc oznaczony jako polecany Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "documentId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "publishedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "nazwaProduktu": { "type": "string" }, "polecany": { "type": "boolean" }, "zdjecie": { "allOf": [ { "$ref": "#/components/schemas/UploadFile" } ], "description": "Returned when the field is populated." }, "krotkiOpis": { "type": "string" }, "endpointDocelowy": { "type": "string" }, "sklepy": { "type": "array", "items": { "$ref": "#/components/schemas/StoreDocument" }, "description": "Returned when the field is populated." } }, "required": [ "id", "documentId", "createdAt", "updatedAt", "publishedAt", "nazwaProduktu", "polecany", "endpointDocelowy" ], "additionalProperties": false }, "StoreDocument": { "type": "object", "description": "Glowny profil sklepu lub marki Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "documentId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "publishedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "nazwaSklepu": { "type": "string" }, "slug": { "type": "string" }, "czyAktywny": { "type": "boolean" }, "priorytetSortowania": { "type": "integer" }, "kategorie": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryDocument" }, "description": "Returned when the field is populated." }, "tagiFiltry": { "type": "array", "items": { "$ref": "#/components/schemas/TagDocument" }, "description": "Returned when the field is populated." }, "typDostawcy": { "type": "string", "enum": [ "Producent", "Dystrybutor" ] }, "logo": { "allOf": [ { "$ref": "#/components/schemas/UploadFile" } ], "description": "Returned when the field is populated." }, "zdjecieGlowne": { "allOf": [ { "$ref": "#/components/schemas/UploadFile" } ], "description": "Returned when the field is populated." }, "zajawka": { "type": "string" }, "opisGlownySeo": { "type": "string" }, "linkAfiliacyjnyGlobalny": { "type": "string" }, "linkWww": { "type": "string" }, "telefonKontaktowy": { "type": "string" }, "emailKontaktowy": { "type": "string", "format": "email" }, "czyPosiadaSklepOnline": { "type": "boolean" }, "dataOstatniejWeryfikacji": { "type": "string", "format": "date" }, "filaryPrawdziwosci": { "type": "array", "items": { "$ref": "#/components/schemas/SekcjeFilarPrawdziwosciComponent" }, "description": "Returned when the field is populated." }, "kodyRabatowe": { "type": "array", "items": { "$ref": "#/components/schemas/SprzedazKodRabatowyComponent" }, "description": "Returned when the field is populated." }, "produkty": { "type": "array", "items": { "$ref": "#/components/schemas/ProduktDocument" }, "description": "Returned when the field is populated." }, "czySklepStacjonarny": { "type": "boolean" }, "lokalizacjeStacjonarne": { "type": "array", "items": { "$ref": "#/components/schemas/KontaktLokalizacjaStacjonarnaComponent" }, "description": "Returned when the field is populated." }, "socialMedia": { "allOf": [ { "$ref": "#/components/schemas/KontaktSocialMediaComponent" } ], "description": "Returned when the field is populated." }, "powiazaneSklepy": { "type": "array", "items": { "$ref": "#/components/schemas/StoreDocument" }, "description": "Returned when the field is populated." } }, "required": [ "id", "documentId", "createdAt", "updatedAt", "publishedAt", "nazwaSklepu", "slug", "typDostawcy" ], "additionalProperties": false }, "TagDocument": { "type": "object", "description": "Tagi filtrow sklepow Relations, media fields, and components are returned when requested with the `populate` query parameter.", "properties": { "id": { "type": "integer" }, "documentId": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "publishedAt": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ] }, "nazwaTagu": { "type": "string" }, "slugTagu": { "type": "string" } }, "required": [ "id", "documentId", "createdAt", "updatedAt", "publishedAt", "nazwaTagu", "slugTagu" ], "additionalProperties": false } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "API Token", "description": "Strapi API token sent as `Authorization: Bearer `." } } } }