{ "variable": [ { "id": "baseUrl", "key": "baseUrl", "type": "string", "name": "string", "value": "https:\/\/api.psiproductfinder.de" } ], "info": { "name": "PSI Backend API (2.0.0)", "_postman_id": "94390e0f-865a-4812-b445-e8bd52a2b5ff", "description": "This is the PSI Backend API Documentation.", "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json" }, "item": [ { "name": "Authentication", "description": "", "item": [ { "name": "Authenticate", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/auth", "query": [], "raw": "{{baseUrl}}\/v2\/auth" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"username\":\"demo@psi-network.de\",\"password\":\"password\"}" }, "description": "This endpoint allows you to authenticate and retrieve an access_token<\/b> and a refresh_token<\/b>.\nThe access_token<\/b> must be included in the header of every API request to access protected resources.\nYou can log in using your standard PSI account credentials. However, to avoid potential issues caused by password changes of regular user accounts,\nwe strongly recommend creating a dedicated Sub-Account for API access. You can set up a Sub-Account in your PSI account settings (https:\/\/www.psi-network.de\/)<\/a>.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\"access_token\": \"eyJ0eXAidemoV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJwcLmRlIiwiYXVkIjoicHNpcHJvZHVjdansmRlci5kZSIsImp0adIeoQzNjMwIiwiaWF0IjoxNzM3MDE5NTQ2LjE2OTkyMiwibmJmIjoxNzM3MDE5NTQ2LjE2OTkyMiwiZXhwIjoxNzM3MDE5NTQ2LjE2OTkyMiwicGF5bG9hZCI6eyJwc2lubyI6NDM2MzAsInVzZXJfaWQiOjEyNDcyOSwiZ3JvdXBzIjoiMTQiLCJlbWFpbCI6ImZyYW5rQHJoZWluc2NoYWZlLmRlIn19\", \"refresh_token\": \"07070512341eacdemo3a64267c377cdcf06501\", \"expires_in\": 1737019546}", "name": "" }, { "header": [], "code": 400, "body": "{\"errors\": \"Username or Password is wrong.\"}", "name": "" } ] }, { "name": "Refresh Token", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/refresh", "query": [], "raw": "{{baseUrl}}\/v2\/refresh" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"username\":\"demo@psi-network.de\",\"refresh_token\":\"07070512341eacdemo3a64267c377cdcf06501\"}" }, "description": "Your access_token<\/b> is valid for the duration specified in the expires_in<\/b> field of the authentication response (e.g., typically 1 hour). Once the token expires, you must generate a new one to continue accessing protected resources.", "auth": { "type": "noauth" } }, "response": [ { "header": [], "code": 200, "body": "{\"access_token\": \"eyJ0eXAidemoV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJwcLmRlIiwiYXVkIjoicHNpcHJvZHVjdansmRlci5kZSIsImp0adIeoQzNjMwIiwiaWF0IjoxNzM3MDE5NTQ2LjE2OTkyMiwibmJmIjoxNzM3MDE5NTQ2LjE2OTkyMiwiZXhwIjoxNzM3MDE5NTQ2LjE2OTkyMiwicGF5bG9hZCI6eyJwc2lubyI6NDM2MzAsInVzZXJfaWQiOjEyNDcyOSwiZ3JvdXBzIjoiMTQiLCJlbWFpbCI6ImZyYW5rQHJoZWluc2NoYWZlLmRlIn19\", \"expires_in\": 1737020073}", "name": "" } ] } ] }, { "name": "Product Controller", "description": "", "item": [ { "name": "Get Entities", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/products", "query": [ { "key": "language", "value": "en", "description": "", "disabled": false }, { "key": "locale", "value": "en", "description": "", "disabled": false }, { "key": "filter", "value": "outdated", "description": "", "disabled": false }, { "key": "search", "value": "Suchen", "description": "", "disabled": false }, { "key": "page", "value": "1", "description": "Must be at least 1.", "disabled": false }, { "key": "size", "value": "2", "description": "Must be at least 1. Must not be greater than 100.", "disabled": false } ], "raw": "{{baseUrl}}\/v2\/products?language=en&locale=en&filter=outdated&search=Suchen&page=1&size=2" }, "method": "GET", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": null, "description": "The Get Entities endpoint allows you to retrieve all products associated with your PSI number. It returns all products that belong to your account, but you can customize the results using optional query parameters." }, "response": [ { "header": [], "code": 200, "body": "{\"code\": 200, \"status\": \"OK\", \"data\": [], \"meta\": {} }", "name": "" }, { "header": [], "code": 400, "body": "{\"code\": \"404\", \"status\": \"Not found\", \"message\": \"No products found.\"}", "name": "" } ] }, { "name": "Create Entity", "request": { "url": { "host": "{{baseUrl}}", "path": "v2\/products\/store", "query": [], "raw": "{{baseUrl}}\/v2\/products\/store" }, "method": "POST", "header": [ { "key": "Content-Type", "value": "application\/json" }, { "key": "Accept", "value": "application\/json" } ], "body": { "mode": "raw", "raw": "{\"name\":\"Demo Product\",\"product_number\":\"demo-001\",\"language\":\"en\",\"locale\":\"en\",\"master_product_number\":\"demo-001\",\"brand\":\"PSI-Demo\",\"description\":\"This is just a demo product\",\"tags\":\"demo1, demo2\",\"ean_code\":\"1234567890\",\"product_groups\":[\"05138008\",\"08094001\"],\"certificates\":[\"CERT-04200000\"],\"colors\":[\"CG-BLAK5\"],\"color_description\":\"red\",\"country_origin\":\"CC-DE\",\"made_in\":\"CC-DE\",\"images\":[{\"src\":\"https:\\\/\\\/psiproductfinder.de\\\/images\\\/logo\\\/logo.svg\",\"name\":\"Demo logo image\",\"description\":\"Custom description\"}],\"delivery_time_max\":3,\"delivery_time_min\":1,\"finishings\":[{\"group\":\"FG-APPN11\",\"included\":true,\"description\":\"Demo application\"}],\"finishings_information\":\"Finishing information\",\"legal_information\":\"Legal information\",\"material_description\":\"Material description\",\"materials\":[\"MG-ACRC7\"],\"measurement_length\":100,\"measurement_volume\":10,\"measurement_height\":150,\"measurement_width\":135,\"measurement_information\":\"Measurement information\",\"weight_netto\":10,\"weight_brutto\":13,\"minimum_order_amount\":1,\"packaging\":2,\"price_ranges\":[{\"amount\":1,\"price_ek\":1.5,\"price_uvp\":2},{\"amount\":5,\"price_ek\":1,\"price_uvp\":1.5}],\"price_ranges_information\":\"Price ranges information\",\"product_information\":\"Product information\",\"stock_available\":true,\"delivery_information\":\"Delivery information\",\"target_group\":\"Target group\",\"video\":\"https:\\\/\\\/www.youtube.com\\\/watch?v=pCHJAj5oPu0\"}" }, "description": "To create a variant or translation, simply post a payload containing the required parameters. If you specify a language other than the default (en), a new translation for the specified language will be added.
\n