Czym jest Application Programming Interface (API)?

Application Programming Interface (API) to zestaw zasad, które pozwalają jednej aplikacji poprosić inną o dane lub wykonanie akcji, a następnie otrzymać przejrzystą odpowiedź. Pomyśl o tym jak o menu w restauracji dla oprogramowania. Zamawiasz to, czego chcesz, a kuchnia dostarcza.

Mit

APIs są tylko dla programistów. To nieprawda. Kontaktujesz się z Application Programming Interface (API) za każdym razem, gdy twój portfel pobiera ceny tokenów, twój bot sprawdza opłaty gas lub aplikacja giełdy pokazuje otwarte zlecenia. Cichy mechanizm, duże korzyści.

Jak działa Application Programming Interface (API)

Wyobraź sobie aplikację portfelową, która obserwuje rynek, a następnie kupuje, gdy twoje powiadomienie zostanie uruchomione. Krótki opis poniżej.

Krok 1: Wyzwalacz uruchamia się lub naciskasz Kup.
Krok 2: Aplikacja wysyła żądanie do punktu końcowego z parą, stroną i wielkością.
Krok 3: Klucz lub podpis potwierdza, że wywołanie jest autoryzowane.
Krok 4: Serwer wykonuje akcję, zapisuje ją i zwraca ustrukturyzowane dane, często w formacie JSON.
Krok 5: Aplikacja pokazuje wypełnienie zlecenia, aktualizuje twój balans i zapisuje błędy. Tak wygląda przepływ.

Dlaczego Application Programming Interface (API) ma znaczenie

Dlaczego warto zwrócić uwagę nawet jeśli nigdy nie piszesz kodu:

Korzyść: Szybkość i przejrzystość. Ceny, salda i transakcje pojawiają się w czasie rzeczywistym.
Perspektywa: Portfele, giełdy, orakle i boty łączą się jak klocki Lego dla dorosłych.
Znaczenie: Spotkasz je w portfelach, dappach, DAO, narzędziach podatkowych, powiadomieniach i analizach.

Wskazówka

Zacznij od kluczy tylko do odczytu zanim wykonasz operacje zapisu. Ogranicz zakres uprawnień, dodaj reguły dla adresów IP i testuj z małym saldem lub na sieci testowej. Najpierw mały krok, potem większe kroki.

Kluczowe cechy Application Programming Interface (API)

Cechy, które czynią je praktycznym:

Format: Przewidywalne zapytania i odpowiedzi, często w JSON, dzięki czemu obie strony zgadzają się co do formatu.
Auth: Klucze lub podpisy potwierdzają, kto wywołuje i co jest dozwolone.
Limity: Ograniczenia liczby zapytań utrzymują usługę stabilną i zniechęcają spam.
Wersjonowanie: Nowe funkcje są wprowadzane bez łamania starszych aplikacji.
Dokumentacja: Referencje pokazują punkty końcowe, parametry i kody błędów dla szybkich napraw.

Wariacje

Główne odmiany, które spotkasz w kryptowalutach:

REST: Jasne zapytania i odpowiedzi przez HTTP do cen i sald.
GraphQL: Żądaj tylko pól, których potrzebujesz, w jednym wywołaniu.
WebSocket: Strumienie w czasie rzeczywistym dla transakcji, zdarzeń mempool i zmian cen.
JSONRPC: Standardowe wywołania do węzła w celu wysłania transakcji i pobrania salda.
SDK: Biblioteka kliencka, która opakowuje typowe wywołania, oszczędzając czas.

Przypomnienie

Traktuj klucze API jak prawie pieniądze. Przechowuj je poza repozytoriami, rotuj je często i utrzymuj wąskie zakresy uprawnień. Dokumentacja Application Programming Interface (API) może się zmieniać, więc zasubskrybuj aktualizacje zanim twój bot się pomyli.

Przykład

Twój portfel wywołuje Application Programming Interface (API) aby pobrać saldo ETH, a potem inne, aby przeliczyć tę kwotę na dolary do wyświetlenia.

Ciekawostka

Termin API jest starszy od kryptowalut o dekady, a JSON RPC stał się powszechnym językiem dla klientów Ethereum na długo zanim eleganckie portfele uczyniły go bardziej przyjaznym.

Podsumowanie

W jednym zdaniu Application Programming Interface (API) to menu, które pozwala aplikacjom żądać danych lub działań w powtarzalny sposób, od sprawdzania cen po transakcje on chain.

Application Programming Interface (API)