{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"9f61501f-dcb1-429b-8cff-d453fa51486a","name":"Telegram API user Wappi.pro","description":"## Описание Telegram API для сервиса Wappi\n\nС помощью этого API можно осуществлять прием и отправку сообщений через HTTP-запросы, а также работать с чатами, контактами, группами и каналами. Это так называемый Telegram User API, который подойдет, если вы хотите использовать личный телеграм аккаунт в качестве userbot или для иных действий.\n\n**МЕТОДЫ ОТПРАВКИ СООБЩЕНИЯ**\n\nВы можете отправить сообщение в Telegram синхронной или асинхронной командой. Асинхронные методы выполняют запросы с постановкой в очередь, в ответе придет сообщение о постановке в очередь и id задачи. Синхронные методы отправления сообщений выполняются сразу и позволяют получить в ответе результат запроса.\n\n**БЕЗОПАСНОСТЬ**\n\nМы используем API Telegram, который является частью экосистемы Telegram. Если вы используете наш API для флуда, спама, фейковых подписчиков, счетчиков просмотров каналов, Telegram может вас забанить. Рекомендуем использовать свои собственные socks5 прокси для подключения.\n\n**ОСОБЕННОСТИ API**\n\nТокен авторизации передается в заголовке Authorization HTTP запроса. Profile_id передается query параметром в каждом запросе.\n\n**ТЕСТИРОВАНИЕ API**\n\nЧтобы протестировать API необходимо авторизоваться. Для этого на данной странице нажмите Authorize, в появившемся окне в поле Value вставьте ваш токен api. Токен можно найти в дашборде на странице вашего профиля - [Вход в личный кабинет](https://wappi.pro/#login-popup).\n\n**КОЛЛЕКЦИЯ POSTMAN**\n\nДля удобства тестирования нашего API можете воспользоваться [коллекцией Postman](https://documenter.getpostman.com/view/24312097/2sA2xb7G51). Там же можно найти примеры реализованных методов на разных языках программирования.\n\n**ВИДЫ ОГРАНИЧЕНИЙ TELEGRAM (FLOOD_WAIT)**\n\nTelegram может временно ограничить выполнение операции. В этом случае возвращается ошибка с кодом FLOOD_WAIT, описанием ограниченной операции и временем ожидания перед повторной попыткой.\n\n**Пример**:\n\n``` json\n{\n  \"status\": \"error\",\n  \"detail\": \"Telegram ограничил отправку сообщения (messages.sendMessage). Повторите через 120 секунд\",\n  \"error_code\": \"FLOOD_WAIT\",\n  \"rpc_method\": \"messages.sendMessage\",\n  \"retry_after\": 120\n}\n\n ```\n\n**Поля ошибки:**\n\n- status — результат выполнения: error.\n    \n- detail — текстовое описание ограничения.\n    \n- error_code — код ошибки: FLOOD_WAIT.\n    \n- rpc_method — техническое название операции, которую ограничил Telegram.\n    \n- retry_after — время ожидания в секундах перед повторной попыткой.\n    \n\n**Обработка ошибки:** при получении FLOOD_WAIT необходимо выждать время, указанное в retry_after, прежде чем повторять ограниченную операцию. Для программной обработки используйте error_code, rpc_method и retry_after, а не текст поля detail.\n\n**Значения поля** rpc_method\n\nДля следующих операций в поле detail предусмотрено понятное текстовое описание:\n\n- contacts.getContacts — получение списка контактов.\n    \n- contacts.resolvePhone — поиск контакта по номеру телефона.\n    \n- contacts.resolveUsername — поиск контакта по username.\n    \n- contacts.importContacts — импорт контактов.\n    \n- messages.sendMessage — отправка сообщения.\n    \n- messages.sendMedia — отправка вложения.\n    \n- messages.sendMultiMedia — отправка коллекции вложений.\n    \n- messages.forwardMessages — пересылка сообщения.\n    \n- upload.getFile — скачивание файла.\n    \n- upload.saveFilePart / upload.saveBigFilePart — загрузка файла в Telegram.\n    \n\nДля остальных операций в поле detail возвращается общее описание: «Telegram ограничил вызов …» с указанием времени ожидания.\n\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"24312097","collectionId":"9f61501f-dcb1-429b-8cff-d453fa51486a","publishedId":"2sA2xb7G51","public":true,"publicUrl":"https://documenter-api.postman.tech/view/24312097/2sA2xb7G51","privateUrl":"https://go.postman.co/documentation/24312097-9f61501f-dcb1-429b-8cff-d453fa51486a","customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"Telegram API user Wappi.pro"},{"name":"title","value":""}],"appearance":{"default":"light","themes":[{"name":"dark","logo":null,"colors":{"top-bar":"212121","right-sidebar":"303030","highlight":"FF6C37"}},{"name":"light","logo":null,"colors":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"}}]}},"version":"8.12.10","publishDate":"2024-03-03T10:36:59.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"","description":"Telegram API user Wappi.pro"},"logos":{"logoLight":null,"logoDark":null}},"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/b811d7bc21ea4a68e2fb6f0ebf68d33db07b26d984b4aa88a3a457d0cf96fff5","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/2sA2xb7G51"}