API Echo
Publiczne REST API i webhooki: podłącz ekonomię, poziomy i kartę serwera w katalogu do własnych usług — serwera gry, strony, bota albo automatyzacji.
Zapytania idą na poniższy adres. W nagłówku Authorization przekazuje się klucz serwera: czyta i zmienia dane tylko swojego serwera i tylko w granicach zakresów wybranych przy tworzeniu. Metody działu „Katalog” są otwarte dla wszystkich i działają bez klucza.
https://api.echo-assistants.tech
Jak uzyskać klucz
- Zaloguj się do portalu przez Discord. Klucze tworzy tylko właściciel serwera, na którym jest Echo.
- Otwórz „Klucze API” i wybierz serwer.
- W bloku „Nowy klucz” podaj nazwę i zaznacz zakresy dostępu. Wybieraj tylko te, które są potrzebne twojemu systemowi.
- Kliknij „Utwórz klucz” i od razu go skopiuj. Cały klucz jest pokazywany tylko raz.
- Sprawdź klucz zapytaniem
GET /me: w odpowiedzi przyjdą serwer i zakresy klucza.
Działy dokumentacji
- AutoryzacjaKlucz w nagłówku Authorization, postać klucza i co robić, jeśli wyciekł.
- EkonomiaSaldo członka, naliczanie i pobieranie waluty, ranking sald.
- PoziomyDoświadczenie i poziom członka, naliczanie doświadczenia, ranking doświadczenia.
- Katalog serwerówKarta twojego serwera w katalogu i ranking serwerów według Płomieni.
- IntegracjeAtrybuty członków, powiązanie kont kodem, nadawanie ról i wiadomości od bota.
- KatalogWyszukiwanie serwerów, karty, opinie i tagi katalogu. Klucz nie jest potrzebny.
- WebhookiZdarzenia, które Echo wysyła na twój adres, i weryfikacja podpisu.
- Powiadomienia integracjiPowiadomienia modułu „Integracje”: zdarzenia, powtórzenia i weryfikacja podpisu w Node.js i PHP.
- Zakresy, limity i błędyUprawnienia każdego zakresu, limit częstotliwości zapytań i kody błędów.