Platforma deweloperska

Platforma deweloperska to miejsce, w którym uruchamiasz, monitorujesz i konfigurujesz wszystko związane z integracją Meshy API — Playground do testowania punktów końcowych bez pisania kodu, panele obejmujące każde żądanie API na Twoim koncie oraz zarządzanie kluczami API i webhookami.

Konta Free mogą testować Playground tylko na punkcie końcowym Obraz na 3D, korzystając z dedykowanego wbudowanego klucza do testów — konta Free nie mogą tworzyć ani zarządzać własnymi kluczami API i nie mają dostępu do panelu użycia ani dzienników żądań. Plany Pro, Premium, Ultra, Studio i Enterprise mają dostęp do każdego punktu końcowego w Playground, pełny dostęp do panelu użycia i dzienników żądań oraz własne klucze API.

Przegląd

Otwórz Platformę deweloperską w aplikacji webowej. Jej pasek boczny jest podzielony na:

Build — Playground do interaktywnego testowania punktów końcowych.
Monitor — panel użycia i dzienniki żądań.
Configure — klucze API i Webhooks.

Sama strona przeglądu prowadzi nowe konta przez trzy poniższe kroki (utworzenie klucza, wypróbowanie żądania w Playground, sprawdzenie wyniku w dziennikach żądań), a następnie pokazuje 7-dniowy zrzut aktywności Twojego konta oraz najnowsze wpisy z dziennika zmian Meshy API.

Strona przeglądu Platformy deweloperskiej, pokazująca trzykrokową kartę wprowadzającą, 7-dniowy zrzut użycia oraz najnowsze aktualizacje dziennika zmian Meshy API

Nowy w API? Zacznij od Szybkiego startu.

Playground

Playground to interaktywna konsola do testowania punktów końcowych bez pisania jakiegokolwiek kodu. Wybierz punkt końcowy, wypełnij parametry korzystając z podpowiedzi w interfejsie i wyślij żądanie — zadania przechodzą przez ten sam asynchroniczny proces co w API, więc zobaczysz, jak zadanie zmienia stan z PENDING na SUCCEEDED, i będziesz mógł sprawdzić pełną odpowiedź oraz wynikowy model.

Playground wykonujący żądanie Obraz na 3D, z podglądem modelu na żywo obok zakładek Preview, Request i Response

Podczas gdy zadanie jest wykonywane, zakładka Preview przesyła aktualizacje statusu na żywo — nie ma potrzeby odpytywania (polling).

Dziennik zakładki Preview w Playground, przesyłający aktualizacje statusu na żywo, gdy zadanie jest w toku

Przełącz się na zakładkę Request, aby uzyskać gotowy do uruchomienia fragment kodu w cURL, Pythonie lub JavaScript, lub na zakładkę Response, aby sprawdzić pełną odpowiedź JSON — to właśnie tutaj Playground pokazuje swoją przewagę nad obszarem roboczym aplikacji webowej: każde zbudowane przez Ciebie żądanie jest o jedno kopiuj-wklej od uruchomienia we własnym kodzie.

Zakładki Request i Response

To samo zadanie, przedstawione na dwa sposoby: odpowiadające mu żądanie cURL oraz surowa odpowiedź JSON.

Zakładka Request w Playground pokazująca odpowiadające polecenie cURL dla bieżącego żądania — Request

Zakładka Response w Playground pokazująca surową odpowiedź JSON — Response

Panel użycia

Panel użycia wizualizuje całą aktywność API na Twoim koncie — każde żądanie, niezależnie od tego, czy zostało wykonane bezpośrednio przez API, czy z poziomu Playground. Pokazuje wskaźnik powodzenia generowania, łączną liczbę żądań, średni czas przetwarzania i zużyte kredyty, a także wolumen żądań w czasie oraz podział wskaźnika powodzenia i opóźnień według punktu końcowego.

Panel użycia pokazujący wskaźnik powodzenia generowania, wolumen żądań w czasie oraz podział wskaźnika powodzenia i opóźnień według punktu końcowego

Dzienniki żądań

Dzienniki żądań wyświetlają każde zadanie API na Twoim koncie — zarówno bezpośrednie wywołania API, jak i żądania z Playground — wraz ze statusem, czasem trwania oraz kluczem API, który wykonał żądanie. Wybierz zadanie, aby zobaczyć jego pełne dane wejściowe i wyjściowe, treść żądania oraz zużyte kredyty — przydatne do debugowania konkretnego wywołania bez ponownego odpytywania API — lub przejdź od razu do niego w Playground. Użyj Export CSV, aby pobrać całą listę do celów raportowania lub uzgadniania danych.

Dzienniki żądań z wybranym zadaniem, którego status, podgląd danych wejściowych/wyjściowych oraz treść żądania są widoczne w panelu szczegółów — wyróżnione przyciski Export CSV oraz Open in Playground

Zarządzanie API

Klucze API — twórz, nazywaj i unieważniaj klucze, ustawiaj miesięczny limit kredytów dla każdego z nich oraz sprawdzaj użycie każdego klucza.
Webhooks — otrzymuj aktualizacje w czasie rzeczywistym, gdy status Twoich zadań API się zmienia, zamiast odpytywania. Zobacz przewodnik Webhooks, aby poznać kroki konfiguracji, wymagania dotyczące dostarczania oraz przykładowe ładunki danych.

Opinie

Każda strona w Platformie deweloperskiej ma przycisk Feedback w prawym dolnym rogu — użyj go, aby zgłosić błąd, poprosić o nową funkcję lub powiedzieć nam, co jest niejasne. Czytamy każde zgłoszenie.

Uwierzytelnianie i kredyty

Żądania są autoryzowane za pomocą klucza API przekazywanego w nagłówku Authorization: Bearer, dokładnie tak samo jak w przypadku bezpośredniego wywołania API. Playground działa na Twoim własnym koncie, więc każde żądanie wykorzystuje kredyty z Twojego planu i wlicza się do limitów szybkości (rate limits), tak samo jak każde inne wywołanie API. Zobacz przewodnik Uwierzytelnianie, aby poznać szczegóły dotyczące formatów kluczy i bezpieczeństwa.