Tekst źródłowy strony Interfejs programowania aplikacji

'''Interfejs programowania aplikacji'''<ref name=Standard_API /><ref name=dyrektywa>Dyrektywa Parlamentu Europejskiego i Rady (UE) 2018/1972 z dnia 11 grudnia 2018 r. ustanawiająca Europejski kodeks łączności elektronicznej ({{CELEX|32018L1972}}).</ref><ref>{{Cytuj stronę |url = https://pclab.pl/art17356-2.html |tytuł = Słowniczek pojęć |opublikowany = PCLab |data dostępu = 2020-04-19}}</ref><ref>{{Cytuj stronę |url = http://www.itcmp.pwr.wroc.pl/~jwach/Techniczny%20EN-PL.htm |tytuł = Słownik Politechniki Wrocławskiej |opublikowany = itcmp.pwr.wroc |data dostępu = 2020-04-19 |archiwum = https://web.archive.org/web/20200217125954/http://www.itcmp.pwr.wroc.pl/~jwach/Techniczny%20EN-PL.htm |zarchiwizowano = 2020-02-17 }}</ref><ref>{{Cytuj stronę |url = https://support.google.com/adsense/answer/32755?hl=pl |tytuł = Słowniczek. Interfejs API |opublikowany = google.com |data dostępu = 2020-04-19}}</ref>, '''interfejs programistyczny aplikacji'''<ref name=Standard_API>{{Cytuj stronę |url = https://www.gov.pl/web/popcwsparcie/standard-api-dla-udostepniania-danych |tytuł = Standard API dla udostępniania danych |data dostępu = 2020-03-11}}</ref><ref>{{Cytuj stronę |url = https://mc.bip.gov.pl/rok-2017-2018-2019/ekspertyza-minimalne-rekomendowane-zalecenia-dotyczace-interfejsu-programistycznego-aplikacji-dostepu-do-baz-danych-przechowujacych-zasoby-publiczne.html |tytuł = Ekspertyzy dotyczące standardów otwartości danych publicznych |opublikowany = Ministerstwo Cyfryzacji |data dostępu = 2020-04-19}}</ref><ref>[https://sjsi.org/download/9147/ Słownik terminów testowych ISTQB], Wersja 3.4 (2020), s. 33.</ref><ref>Ustawa z dnia 12 lipca 2024 r. [[Prawo komunikacji elektronicznej]] ({{Dziennik Ustaw|2024|1221}}).</ref> , '''interfejs programu aplikacyjnego'''<ref name=dyrektywa />({{ang.|application programming interface}}, '''{{J|en|API}}''') – zbiór reguł ściśle opisujący, w jaki sposób [[Program komputerowy|programy]] lub podprogramy komunikują się ze sobą<ref name=API>{{Cytuj stronę |url = https://dane.gov.pl/media/ckeditor/2018/12/05/standard-api_03-12-2018.pdf |tytuł = Standard API (interfejsu programistycznego aplikacji) |strony = 3 |data dostępu = 2020-03-11}}</ref>.

API jest przede wszystkim specyfikacją wytycznych, jak powinna przebiegać interakcja między komponentami programowymi. [[Implementacja (informatyka)|Implementacja]] API jest zestawem rutyn, protokołów i rozwiązań informatycznych do budowy aplikacji komputerowych. Dodatkowo API może korzystać z komponentów [[Graficzny interfejs użytkownika|graficznego interfejsu użytkownika]]. Dobre API ułatwia budowę oprogramowania, sprowadzając ją do łączenia przez programistę bloków elementów w ustalonej konwencji<ref>{{Cytuj stronę |url = https://www.gov.pl/attachment/ae0e670a-d16d-443d-a994-55727e18288b |tytuł = OD.API standardy interfejsu programistycznego aplikacji |strony = 3 |data dostępu = 2020-03-11}}</ref>.

Definiuje się go na poziomie [[kod źródłowy|kodu źródłowego]] dla składników oprogramowania, na przykład [[oprogramowanie użytkowe|aplikacji]], [[biblioteka programistyczna|bibliotek]], [[system operacyjny|systemu operacyjnego]]. Zadaniem interfejsu programowania aplikacji jest dostarczenie odpowiednich specyfikacji [[podprogram]]ów, [[struktura danych|struktur danych]], [[klasa (programowanie obiektowe)|klas obiektów]] i wymaganych [[protokół komunikacyjny|protokołów komunikacyjnych]].

Definicja API może być niezależna od jego implementacji. Przykładowo, istnieje wiele realizacji API [[Biblioteka standardowa języka C|biblioteki standardowej języka C]], które współdzielą standardową zewnętrzną funkcjonalność (są to m.in. wersja z systemu [[Berkeley Software Distribution|BSD]] oraz wersja z systemu [[GNU]]<ref>[https://www.gnu.org/software/libc/ Biblioteka standardowa jęz. C w wersji GNU] {{lang|en}}.</ref>).

Co więcej, istnieją API zdefiniowane w sposób niezależny od danej platformy (systemu operacyjnego, języka programowania), dla których istnieje możliwość wygenerowania API dla specyficznej platformy. Takie interfejsy definiuje się, używając zwykle [[język opisu interfejsu|języków ich opisu]].

Przykładowe API to [[POSIX]] (API zdefiniowane w [[C (język programowania)|języku C]]) i [[Windows API]] (API zdefiniowane w języku C)<ref name="petzold_windows">Charles Petzold, ''Programowanie Windows. Kompletny podręcznik Win32 API do Windows 95/98/NT''. Wydanie II, Wydawnictwo RM.</ref>, a w przypadku [[Grafika 3D|grafiki 3D]] – [[Vulkan (API)|Vulkan]] (API zdefiniowane dla języka C, z wieloma tzw. bindingami, m.in. dla [[C++|jęz. C++]], [[Rust (język programowania)|jęz. Rust]] i innych) oraz [[OpenGL]]<ref>{{Cytuj stronę | url = http://www.opengl.org/ | tytuł = {{J|en|OpenGL – The Industry’s Foundation for High Performance Graphics}} | opublikowany = opengl.org | archiwum = https://web.archive.org/web/20110226000710/http://www.opengl.org/ | zarchiwizowano = 2011-02-26}} {{lang|en}}.</ref> (API zdefiniowane dla wielu języków, m.in. C, C++, [[Java]], [[Python]]).

Jednym z typów API, które przebiły się do szerszej świadomości, są [[WebAPI|API webowe]] (zwane też internetowymi). Jest to rodzaj API, w których funkcje są udostępniane jako zasób w sieci. Bieżące wersje systemów API webowych pozwalają w bardzo łatwy sposób integrować informacje z sieci z aplikacjami, poszerzając ich funkcje lub umożliwiając współdziałanie (na przykład z sieciami społecznościowymi)<ref name="jacobson_et_al">Daniel Jacobson, Dan Woods, Greg Brail, ''Interfejs API: Strategia programisty'', Helion, Gliwice, 2015.</ref>.

== Przykłady ==
W języku C definicja interfejsu programowania aplikacji składa się przede wszystkim z listy dostępnych funkcji (w formie prototypów funkcji), wraz z towarzyszącymi im przeważnie definicjami stałych, zmiennych oraz struktur danych, które mogą być użyte jako ich parametry. Przykładowa lista prototypów funkcji z API [[Biblioteka standardowa języka C|biblioteki standardowej języka C]] (plik nagłówkowy <stdio.h>) to:
<syntaxhighlight lang="C">
int printf(const char *format, ...);
int fprintf(FILE *stream, const char *format, ...);
int sprintf(char *str, const char *format, ...);
int snprintf(char *str, size_t size, const char *format, ...);
</syntaxhighlight>
W prototypach funkcji (<code>printf</code>, <code>fprintf</code>, <code>sprintf</code>, <code>snprintf</code>) użyte są identyfikatory struktur i typów (<code>FILE</code> i <code>size_t</code>), które są również częścią definicji API (ich definicja nie została zamieszczona w przykładzie).

Przykład użycia jednej z powyższych funkcji z API jest następujący:
<syntaxhighlight lang="C">
return printf("%s", "Hello world");
</syntaxhighlight>

== Zobacz też ==
{{Wikisłownik|API}}
* [[interfejs binarny aplikacji]] ({{J|en|ABI}})
* [[Single UNIX Specification|{{J|en|Single UNIX Specification}}]]
* [[Komunikacja międzyprocesowa]]

== Przypisy ==
{{Przypisy}}

{{Kontrola autorytatywna}}

[[Kategoria:Interfejsy programistyczne| ]]