Список каналів сервера Discord — це GET на /discord/v1/servers/{guild_id}/channels у MakeHybrid Discord API: це сервери Discord, на які ваша організація додала бота. Кожен запит несе ваш власний ключ у заголовку X-API-KEY — той самий, що й у LinkedIn API — і дістає лише до цих серверів.
Один бот обслуговує всі організації, тож кожен виклик спершу перевіряється за серверами, на які його додали ви, і ніщо з того, що він публікує, нікому не надсилає сповіщень.
Запит
curl -X GET "https://makehybrid.com/discord/v1/servers/$GUILD_ID/channels" \ -H "X-API-KEY: $MAKEHYBRID_KEY"
Що йде у шлях
- guild_id — id, який повернув попередній виклик із цієї родини.
Що приходить, коли не працює
- 401 — ключа немає, він хибний або відкликаний.
- 402 — тариф не оплачено. Тариф MakeHybrid API відповідає так, коли пробний період скінчився.
- 404 — або цього немає, або це не вашої організації. Обидва випадки навмисне дають однакову відповідь, щоб id не можна було перебрати.
- 429 — забагато запитів або платформа просить нас пригальмувати. Зачекайте трохи, перш ніж пробувати знову.
- 502 або 503 — платформа щойно не відповіла. Спробуйте ще раз за хвилину.
Кожна помилка — це JSON однієї форми: {"type":"errors/<code>","status":<n>,"detail":"..."} — тож один обробник покриває всі, а detail написано так, щоб його можна було показати людині.
Попросити асистента
Ця операція — ще й інструмент MCP. Вставте https://makehybrid.com/discord/mcp/<your API key> у Claude, ChatGPT або будь-якого асистента, що говорить MCP, і попросіть звичайними словами — асистент сам обере виклик, підставить id і прочитає вам відповідь. В універсального агента за адресою https://makehybrid.com/mcp/<your API key> він теж є — поруч із LinkedIn API та всіма іншими каналами.
У проєктній кімнаті
У проєктній кімнаті позначте агента цього API в полі «Може використовувати» у свого ШІ-агента — і він викликатиме «Список каналів сервера Discord» як інструмент щоразу, коли це потрібно розмові. Усі в кімнаті бачать, про що він спитав і що повернулося. Просіть звичайними словами; тут агент зветься @scout:
- @scout прочитай останні 20 повідомлень у #support на нашому Discord і скажи, на які запитання ще не відповіли.
Часті запитання
Чи може ШІ-агент викликати «Список каналів сервера Discord» за мене?
Так. Може будь-який асистент, що говорить MCP, — за адресою вище, — і ваш власний ШІ-агент у проєктній кімнаті із позначеним агентом цього API. Вбудовані агенти кімнати не можуть: вони радять, а вашого ключа в них немає.
Чи працює це поза кімнатою, з мого власного коду?
Так. Запит вище — це та сама операція, яку викликає інструмент ШІ-агента, з тією самою відповіддю й тими самими помилками, а ваш ключ дістає до тих самих каналів, яким би шляхом ви не прийшли.
Чи працює це в кімнаті під моїм власним брендом?
Так. На адресі white-label API, його довідник і його ШІ-агент мають назву вашого продукту й дістають до тих самих каналів за тими самими правилами.
У якому тарифі
Входить у тариф MakeHybrid API, з тим самим ключем, що й LinkedIn API: 9 $ за місце на місяць, 7 $ від десяти місць і 5 $ від тисячі. Місць потрібно стільки, скільки у вас того, чого найбільше, — акаунтів LinkedIn, номерів WhatsApp, акаунтів X або акаунтів скриньки, — а 30-денний пробний період покриває одне місце.