Dla deweloperów
API istnieje. Publicznej dokumentacji referencyjnej jeszcze nie ma.
Wszystko na tej platformie (sklep, koszyk, panel) już komunikuje się z jednym API. Nie opublikowaliśmy go jednak: dziś nie ma tokenów dla klientów ani dokumentacji referencyjnej i wolimy to powiedzieć, niż sprzedawać Państwu zrzut ekranu.
Dziś
Jak jest naprawdę w tej chwili.
Sklep i panel już działają na naszym własnym wewnętrznym API. Opublikowanie go oznacza dokumentację, wydawanie tokenów i obietnice stabilności, których potrafimy dotrzymać, a żadna z tych rzeczy jeszcze nie istnieje.
Czego jeszcze nie ma: kluczy API tworzonych samodzielnie, opublikowanej dokumentacji ze schematami i obietnic stabilności, dzięki którym warto budować na API. Dopóki nie spiszemy zasad wersjonowania i wycofywania funkcji, nie wydajemy tokenów. API, które zmienia się pod Państwa nogami, jest gorsze niż brak API.
Jeśli Państwa proces już dziś wymaga programowego uruchamiania serwerów, prosimy opisać, co Państwo budują, przez formularz zapytania. Zainteresowanie naprawdę wpływa na kolejność prac, a wczesny dostęp otrzymają najpierw osoby, które o niego prosiły.
Planowany zakres
Co obejmie publiczne API.
To możliwości, które wewnętrzne API już ma, a publiczne udostępni. Planowane znaczy planowane: dziś klienci nie mogą wywołać żadnej z nich.
- Cykl życia serwera
- Twórz, przebudowuj, restartuj i usuwaj serwery z własnego kodu: te same operacje, które dziś wykonuje panel.
- Katalog na żywo
- Plany, regiony i obrazy systemów jako dane, z tymi samymi cenami co w sklepie, łącznie z rabatem partnerskim, jeśli przysługuje.
- Domeny i DNS
- Wyszukuj, rejestruj domeny i zarządzaj rekordami przez tę samą integrację z rejestratorem, której używa strona.
- Użycie i rozliczenia
- Pomiar godzina po godzinie, odczytywany programowo: liczby potrzebne do refakturowania własnych klientów.
- Webhooki zamiast odpytywania
- Zdarzenia cyklu życia wysyłane i podpisywane na Państwa endpoint, dzięki czemu systemy reagują, zamiast odpytywać.
- Tokeny z ograniczonym zakresem
- Klucze tylko do odczytu, tylko do uruchamiania lub z pełnym dostępem, natychmiast odwoływalne, z dziennikiem audytu dla każdego tokenu.
Zasady, według których budujemy: zwykły REST ze znaczącymi kodami statusu, klucze idempotencji przy wywołaniach modyfikujących, cloud-init user_data przy tworzeniu, limity zapytań podawane w nagłówkach odpowiedzi oraz błędy, które mówią, co zrobić dalej. Celowo nudne.
Zgłoś zainteresowanie
Prosimy napisać, co Państwo by z nim zbudowali.
Wystarczy jedno zdanie o Państwa zastosowaniu. Odezwiemy się, gdy będzie coś realnego do wypróbowania, a nie z serią automatycznych maili.