{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"da6de878-cec6-4fec-bccb-436a356bf225","name":"Hype Exchange Service - API","description":"Hype API е базирано на REST принципите. Използват се стандартни HTTP\n\n## Начално ръководство\n\nЗа да използвате Hype API е необходимо -\n\n- Да се създаде интеграция на вашата платформа с клиент на Hype, при което ще ви бъде предоставен API Key\n    \n- Hype API има следните лимити и ограничения [rate and usage limits](https://postman.postman.co/workspace/Collection-Templates~6311738d-2e70-441f-ae12-78caf078c5b7/collection/22517504-e9c28f47-1253-44af-a2f3-20dce4da1f18?ctx=documentation#rate-and-usage-limits).\n    \n- Hype API отговаря само на HTTPS-secured комуникация.  \n    Всеки рекуест направен към HTTP ще бъде пренасочен с HTTP 301 redirect  \n    към съответния HTTPS ресурс.\n    \n- Когато има грешка, Hype API връща както съответния  \n    Status Code на грешката в хедъра на отговора, така и JSON форматиран  \n    отговор, в следния вид:\n    \n\n```\n{\n   \"error\": 1,\n   \"message\": \"Текст на грешката\"\n}\n\n ```\n\n## Удостоверяване (Authentication)\n\nHype API използва автентикация чрез Authorization header  \nот тип Bearer Token. За да получите такъв токън, трябва да се създаде  \nинтеграция между настоящ клиент на Hype и вашата платформа за което  \nтрябва да се свържите с съпорт центъра на Hype.\n\n### Authentication error response\n\nАко токъна липсва или е невалиден, ще получите грешка от тип 401 (Unauthorized).\n\n## Endpoints\n\n**DEV**: `https://es.dev.hype-software.com`\n\n**LIVE**: `https://es.hype-software.com`\n\n## Rate and usage limits\n\nHype API има ограничение на брой рекуести които могат да  \nсе направят в рамките на една минута. Ограничението е 1000 заявки за  \nминута. Ако се надвишът броя заявки за минута, ще се. върне грешка 429  \n(Too Many Requests).\n\nВ header на всеки върнат отговор след рекуест към Hype API, присъстват следните параметри:\n\n| Header | Description |\n| --- | --- |\n| `X-RateLimit-Limit` | Максималният брой заявки, които потребителят има право да направи за минута. |\n| `X-RateLimit-Remaining` | Броят заявки, оставащи в текущия рейт лимит \"прозорец\". |\n| `X-RateLimit-Reset` | Време (в Unix timestamp) когато настощият рейт лимит ще се ресетне.  <br>❗ _Връща се само в случай надвишаван на лимита._ |\n| `Retry-After` | Време (в секунди) след което може да се направи нов рекуест.  <br>❗ _Връща се само в случай надвишаван на лимита._ |","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":true,"owner":"52109283","team":13316138,"collectionId":"da6de878-cec6-4fec-bccb-436a356bf225","publishedId":"2sBXc8oNnL","public":true,"publicUrl":"https://documenter-api.postman.tech/view/52109283/2sBXc8oNnL","privateUrl":"https://go.postman.co/documentation/52109283-da6de878-cec6-4fec-bccb-436a356bf225","customColor":{"top-bar":"242331","right-sidebar":"242532","highlight":"674AEF"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":""},{"name":"title","value":""}],"appearance":{"default":"dark","themes":[{"name":"dark","logo":"https://content.pstmn.io/35ee7352-d1d0-45ce-9b6d-adc4d2dcb724/VEVGVFZDQW9NU2t1Y0c1bi5wbmc=","colors":{"top-bar":"242331","right-sidebar":"242532","highlight":"674AEF"}},{"name":"light","logo":"https://content.pstmn.io/35ee7352-d1d0-45ce-9b6d-adc4d2dcb724/VEVGVFZDQW9NU2t1Y0c1bi5wbmc=","colors":{"top-bar":"242331","right-sidebar":"242532","highlight":"674AEF"}}]}},"version":"8.12.7","publishDate":"2026-02-05T15:18:48.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":""},"logos":{"logoLight":"https://content.pstmn.io/35ee7352-d1d0-45ce-9b6d-adc4d2dcb724/VEVGVFZDQW9NU2t1Y0c1bi5wbmc=","logoDark":"https://content.pstmn.io/35ee7352-d1d0-45ce-9b6d-adc4d2dcb724/VEVGVFZDQW9NU2t1Y0c1bi5wbmc="}},"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/ff09ab8f5eb325a4f34bfa473864eaefa7bef55e092e192d015fff8c2193cf1a","favicon":""},"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://documenter.gw.postman.com/view/metadata/2sBXc8oNnL"}