Pierwsze kroki z API OVHcloud
Dowiedz się, jak korzystać z API OVHcloud
Dowiedz się, jak korzystać z API OVHcloud
Tłumaczenie zostało wygenerowane automatycznie przez system naszego partnera SYSTRAN. W niektórych przypadkach mogą wystąpić nieprecyzyjne sformułowania, na przykład w tłumaczeniu nazw przycisków lub szczegółów technicznych. W przypadku jakichkolwiek wątpliwości zalecamy zapoznanie się z angielską/francuską wersją przewodnika. Jeśli chcesz przyczynić się do ulepszenia tłumaczenia, kliknij przycisk „Zaproponuj zmianę” na tej stronie.
Ostatnia aktualizacja z dnia 30-05-2022
API dostępne na stronie https://api.ovh.com/ pozwalają na zakup, zarządzanie i konfigurowanie produktów OVHcloud bez konieczności korzystania z interfejsu graficznego, takiego jak Panel klienta.
Dowiedz się, jak korzystać z API OVHcloud oraz jak je łączyć z Twoimi aplikacjami
OVHcloud udostępnia różnorodne usługi, jednak to Ty odpowiadasz za ich konfigurację i zarządzanie nimi. Ponosisz więc odpowiedzialność za ich prawidłowe funkcjonowanie.
Oddajemy w Twoje ręce niniejszy przewodnik, którego celem jest pomoc w wykonywaniu bieżących zadań. W przypadku trudności zalecamy skorzystanie z pomocy wyspecjalizowanego webmastera lub kontakt z producentem oprogramowania. Niestety firma OVH nie będzie mogła udzielić wsparcia w tym zakresie. Więcej informacji znajduje się w sekcji „Sprawdź również”.
Na stronie API OVHcloud kliknij Explore the OVH API
, aby wyświetlić listę API.
Aby korzystać z API na produktach, należy zalogować się na tej stronie za pomocą identyfikatora OVHcloud.
Login
.
Jeśli Twoje konto OVHcloud jest chronione weryfikacją dwuetapową, wpisz również kod wygenerowany w wiadomości SMS lub aplikacji OTP lub klucz U2F.
Po zalogowaniu się znajdziesz listę produktów OVHcloud wyposażonych w API. Wykaz ten jest uporządkowany alfabetycznie.
Aby wyświetlić na przykład API powiązane z domenami, kliknij na /domain na liście.
Po kliknięciu na produkt lista API tego produktu wyświetla się poniżej.
Dostępne są 4 rodzaje API, które wykorzystują tak zwane metody HTTP:
GET
Metoda GET ma na celu odzyskanie danych z zasobu.
Na przykład, aby pobrać listę Twoich domen, użyj następującego API:
POST
Metoda POST jest wykorzystywana do wysyłania dodatkowych danych do zasobu.
Na przykład, aby dodać rekord do strefy DNS, użyj następującego API:
PUT
Metoda PUT służy do zastąpienia aktualnych danych dotyczących zasobu danymi zapytania.
Na przykład, jeśli popełniłeś błąd podczas zapisywania strefy DNS, użyj następującego API:
DELETE
Metoda DELETE jest używana do usuwania nazwanego zasobu.
Na przykład, jeśli nie chcesz zachować rekordu DNS, który dodałeś do strefy DNS, użyj następującego API:
Po kliknięciu na API w wybranej przez Ciebie sekcji Parameters możesz przypisać zmienne związane z aplikacją.
Na przykład, aby dodać rekord TXT do strefy DNS, zoptymalizujesz następujące parametry:
Po zdefiniowaniu ustawień możesz uruchomić API klikając Execute
.
W zakładce Result
wyświetli się raport z realizacji API.
Zakładki PHP
i Python
zawierają elementy, które należy dodać do skryptu w zależności od używanego języka.
Każda aplikacja, która chce komunikować się z API OVHcloud, musi zostać zgłoszona z wyprzedzeniem.
W tym celu kliknij link: https://eu.api.ovh.com/createToken/.
Wpisz identyfikator klienta, hasło i nazwę aplikacji. Nazwa będzie pomocna później, jeśli chcesz zezwolić innym na jej używanie.
Możesz również dodać opis aplikacji oraz czas jej trwania.
Zakres Rights
pozwala na ograniczenie korzystania z aplikacji do niektórych API.
Aby zezwolić wszystkim API OVHcloud dla metody HTTP, wprowadź gwiazdkę *
w polu, jak w poniższym przykładzie, w którym metoda GET jest dozwolona dla wszystkich API:
Po kliknięciu Create keys
otrzymasz trzy klucze:
7kbG7Bk7S9Nt7ZSV
EXEgWIz07P0HYwtQDs7cNIqCiQaWSuHF
MtSwSrPpNjqfVSmJhLbPyr2i45lSwPU1
W tym przypadku klucz CK jest przypisany do Twojego konta.
Token CK może być wykorzystywany do przekazywania uprawnień. Więcej informacji znajdziesz w przewodniku: Jak zarządzać kontem klienta OVHcloud za pomocą API (przewodnik po języku angielskim).
Po uzyskaniu trzech kluczy (AK, AS, CK) możesz podpisać zlecenia API. Podpis oblicza się w następujący sposób:
"$1$" + SHA1_HEX(AS+"+"+CK+"+"+METHOD+"+"+QUERY+"+"+BODY+"+"+TSTAMP)
Aby uprościć programowanie aplikacji, OVHcloud udostępnia wrappery API w kilku językach. Dzięki nim nie będziesz martwił się o obliczenia podpisu i będziesz mógł skupić się na rozwoju Twojej aplikacji.
Przykład zastosowania sekcji /me
, która pozwala na zarządzanie kontem OVHcloud:
import ovh
# Instantiate. Visit https://api.ovh.com/createToken/?GET=/me
# to get your credentials
client = ovh.Client(
endpoint='ovh-eu',
application_key='<application key>',
application_secret='<application secret>',
consumer_key='<consumer key>',
)
# Print nice welcome message
print("Welcome", client.get('/me')['firstname'])
Zarządzanie domeną poprzez API OVHcloud (przewodnik po angielsku)
Jak zarządzać kontem klienta OVHcloud za pomocą API (przewodnik po angielsku)
Przyłącz się do społeczności naszych użytkowników na stronie https://community.ovh.com/en/
Zachęcamy do przesyłania sugestii, które pomogą nam ulepszyć naszą dokumentację.
Obrazy, zawartość, struktura - podziel się swoim pomysłem, my dołożymy wszelkich starań, aby wprowadzić ulepszenia.
Zgłoszenie przesłane za pomocą tego formularza nie zostanie obsłużone. Skorzystaj z formularza "Utwórz zgłoszenie" .
Dziękujemy. Twoja opinia jest dla nas bardzo cenna.
Dostęp do OVHcloud Community Przesyłaj pytania, zdobywaj informacje, publikuj treści i kontaktuj się z innymi użytkownikami OVHcloud Community.
Porozmawiaj ze społecznością OVHcloud