{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"8179c3ce-5306-4985-8ca8-fc183e0d30a3","name":"Plggr API v2023-1","description":"Welcome to the Plggr API documentation\n\n# What is Plggr?\n\nPLGGR is an innovative company specializing in building ecosystems for SaaS solutions. Our mission is to help companies maximize operational efficiency through seamless integration of disparate systems and advanced software solutions. Our products and services enable companies to manage product information, streamline order processing and synchronize data across multiple platforms.\n\n# Who is Plggr API for?\n\nThe PLGGR API is designed for businesses and organizations that seek to streamline their operations, enhance efficiency, and optimize data management processes. It is targeted towards companies that rely on software solutions to manage their product information, order processing, and data synchronization across multiple platforms. Whether it's an e-commerce business, a manufacturing company, or a service provider, the PLGGR API provides a flexible and scalable solution to meet the diverse needs of modern businesses.\n\n# API Limits\n\nThe API limits for PLGGR are designed to ensure optimal performance and fair usage for all users while maintaining system stability. These limits may vary depending on factors such as subscription tier, usage patterns, and specific API endpoints. However, typical API limits may include:\n\n1. Rate Limits: The number of requests that can be made to the API within a specific time frame (e.g., per minute, per hour).\n    \n2. Usage Quotas: The total amount of data that can be processed or retrieved through the API within a given period (e.g., per day, per month).\n    \n3. Concurrent Connections: The maximum number of simultaneous connections allowed to the API server at any given time.\n    \n\nThese limits are set to prevent abuse, ensure fair usage, and maintain system performance for all users.\n\n# Authentication\n\nThe Plggr API uses OAuth (Open Authorization) with Bearer Token authentication to enable secure access to tenants resources. This enables third-party applications access resources without the tenant needing to share their credentials.\n\nTo obtain a valid token the client must supply API credentials (API client id and secret) by sending a POST request to [https://plggr1.eu.auth0.com/oauth/token](https://plggr1.eu.auth0.com/oauth/token). A token is valid for 24 hours, after this period and a new token must be requested to continue accessing the proteced resources.\n\nIf a token cannot be verified, a 401 Unauthorized error will be returned and a new token must be requested.\n\nMore info about using/managing tokens, error codes and formats can be found in the **authentication** section further down in this documentations.\n\n# HTTP Status Codes\n\n| **Status code** | **Description** |\n| --- | --- |\n| 200 OK | The request has succeeded. The response body contains a resourse object |\n| 400 Bad Request | The server cannot or will not process the request due to something that is perceived to be a client error. This is typically because required parameter were not provided in the request. |\n| 401 Unauthorized | The access token is either invalid, expired, or lacks the necessary permissions to access the requested resource |\n| 403 Forbidden | Indicates that the server understands the request but refuses to authorize it. The access is tied to the application logic, such as insufficient rights to a resource. |\n| 404 Not Found | The server cannot find the requested resource. |\n\n# Definitions\n\n| Term | Description |\n| --- | --- |\n| Tenant | Plggr customer that wants it's data managed in the HUB. |\n| Company | Separate entity that has its own context for a tenant. |\n| HUB | A centralized system for integrating, managing and sharing context data of tenants. |\n| PIM | Product Information Management build on top of the HUB for data enrichment of data contexts. |\n| Order Entry | Order application that uses the contexts enriched by the PIM and managed by the HUB. |\n| Client | This is the application that wants to access the tenants resources. |\n\n# Contexts\n\nThe Plggr API is build around _contexts_, a context defines it's data, operations and relationships with other contexts.\n\nContext available are:\n\n- Products\n    \n- Customers\n    \n- Orders","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"3941118","team":255960,"collectionId":"8179c3ce-5306-4985-8ca8-fc183e0d30a3","publishedId":"2sA3JJ82nR","public":true,"publicUrl":"https://apidocs.plggr.net","privateUrl":"https://go.postman.co/documentation/3941118-8179c3ce-5306-4985-8ca8-fc183e0d30a3","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"36C7F1"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/a0249f4f-a700-442d-a090-b369e9230ce5/cGxnZ3ItMTAwLnBuZw==","colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"36C7F1"}},{"name":"light","logo":"https://content.pstmn.io/a0249f4f-a700-442d-a090-b369e9230ce5/cGxnZ3ItMTAwLnBuZw==","colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"36C7F1"}}]}},"version":"8.10.1","publishDate":"2024-05-30T13:11:25.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/a0249f4f-a700-442d-a090-b369e9230ce5/cGxnZ3ItMTAwLnBuZw==","logoDark":"https://content.pstmn.io/a0249f4f-a700-442d-a090-b369e9230ce5/cGxnZ3ItMTAwLnBuZw=="}},"statusCode":200},"environments":[],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/ebff66b1b3a829d459adf8cc320c37f22be643d8c55253e6ac22e4e6114a835c","favicon":"https://plggr.net/favicon.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"}],"canonicalUrl":"https://apidocs.plggr.net/view/metadata/2sA3JJ82nR"}