Przejdź do treści

Utwórz mock REST API

Utwórz fałszywe endpointy JSON z własną metodą, ścieżką, statusem, opóźnieniem i treścią lub wygenerowanymi danymi. Nasz serwer udostępnia je z CORS do prototypów i testów.

Parametr zapisz jako :name, np. /users/:id

Treść odpowiedzi
Opóźnienie0 ms

Ciągi takie jak "{{fullName}}" lub "{{int(1, 100)}}" są zastępowane przy każdym żądaniu.

elementy

0 zwraca pojedynczy obiekt

Symbole zastępcze (36)
{{id}}
1, 2, 3… pozycja na liście
{{index}}
0, 1, 2… pozycja liczona od zera
{{uuid}}
Losowy UUID v4
{{firstName}}
Imię
{{lastName}}
Nazwisko
{{fullName}}
Imię i nazwisko
{{username}}
Nazwa użytkownika małymi literami
{{email}}
Adres w domenie example.com
{{phone}}
Numer telefonu (+1 555…)
{{company}}
Nazwa firmy
{{jobTitle}}
Stanowisko
{{street}}
Adres (ulica)
{{city}}
Miasto
{{country}}
Kraj
{{countryCode}}
Kod ISO 3166
{{zip}}
5-cyfrowy kod pocztowy
{{domain}}
domena example
{{url}}
URL https
{{ipv4}}
IPv4 z zakresu dokumentacyjnego
{{color}}
Kolor HEX
{{word}}
Jedno słowo lorem
{{words}}
words(n): n słów lorem
{{sentence}}
Zdanie lorem
{{paragraph}}
Od trzech do pięciu zdań
{{int}}
int(min, max): liczba całkowita
{{float}}
float(min, max, decimals)
{{price}}
price(min, max): dwa miejsca po przecinku
{{bool}}
true lub false
{{date}}
Data z ostatniego roku (RRRR-MM-DD)
{{datetime}}
Data i czas ISO z ostatniego roku
{{futureDate}}
Data z następnego roku
{{status}}
active, pending lub inactive
{{pick}}
pick(a, b, c): jedna z opcji
{{param}}
param(name): wartość ze ścieżki URL, np. :id
{{query}}
query(name): wartość z ciągu zapytania
{{null}}
JSON null
Nagłówki odpowiedzi (opcjonalnie, tylko X-)
Endpointy: 3 z 10 · odpowiedzi JSON z włączonym CORS
Przetwarzane na naszym serwerze · endpoint JSON jest przechowywany, dopóki go nie usuniesz albo nie minie 7 dni bez żadnego żądaniaJak to działa

Jak korzystać: Mock REST API

  1. 1

    Opisz każdy endpoint

    Wybierz metodę, wpisz ścieżkę, na przykład /users/:id, a potem ustaw kod statusu i opcjonalne opóźnienie, które imituje wolne połączenie.

  2. 2

    Napisz odpowiedź

    Wklej stały JSON albo przełącz na Fałszywe dane i napisz szablon z symbolami zastępczymi, takimi jak {{fullName}}, oraz podaj rozmiar listy.

  3. 3

    Utwórz mock API

    Kliknij Utwórz mock API, aby dostać bazowy URL. Każdy endpoint odpowiada pod tym adresem z dopisaną swoją ścieżką, z włączonym CORS.

  4. 4

    Wywołaj i popraw

    Użyj przycisku Wypróbuj, curl lub fetch w swojej aplikacji, a potem edytuj i zapisuj – zmiany działają od razu – albo usuń mock, gdy skończysz.

Limity i Pro

Za darmo: 10 endpointów na jedno mock API, 100 KB na treść i 512 KB łącznie, opóźnienia do 5 sekund, generowane listy do 100 elementów, 120 żądań na minutę na odwiedzającego, 10 nowych mock API na godzinę, usuwanie po 7 dniach bez żądań.

Pro podnosi limity do 50 endpointów, treści do 1 MB, opóźnień do 30 sekund i list do 1000 elementów. Zobacz Pro

O narzędziu: Mock REST API

Mock REST API daje programistom front-endu i aplikacji mobilnych działające endpointy, zanim powstanie prawdziwy back-end. Każde mock API ma własny bazowy URL pod adresem /api/mock-api/m/, a każdy zdefiniowany endpoint odpowiada tam z wybraną przez Ciebie metodą, ścieżką, kodem statusu, opóźnieniem, nagłówkami i treścią JSON. Ścieżki mogą zawierać parametry, więc /users/:id pasuje do /users/7, a szablon może zwrócić tę wartość przez {{param(id)}} albo odczytać parametr zapytania przez {{query(name)}}.

Tryb fałszywych danych zamienia szablon JSON w realistyczne odpowiedzi dzięki 36 symbolom zastępczym: od imion i nazwisk, adresów e-mail, firm i miast po UUID, daty, ceny, liczby z zakresu i tekst lorem ipsum. Ustaw rozmiar listy, aby dostać tablicę do 100 elementów, i zdecyduj, czy dane mają być takie same przy kolejnych żądaniach (to dobre do testów snapshotowych), czy zmieniać się za każdym razem. Kody statusu od 200 do 599 pozwalają przećwiczyć stany błędów, jak 401, 404, 429 i 503, a opóźnienie do pięciu sekund pokazuje, jak zachowują się Twoje stany ładowania.

Odpowiedzi to zawsze JSON z nagłówkami CORS, więc wywołają je przeglądarki z dowolnego origin. Mock API nie zwraca HTML, nie ustawia ciasteczek ani nie przekierowuje, nie zapisuje odbieranych żądań i nie jest bazą danych: POST i PUT odpowiadają skonfigurowaną treścią, nie zapisując niczego z tego, co do nich wysłano.

Prywatność

Aby udostępniać Twoje endpointy, zapisane definicje – metody, ścieżki, kody statusu, opóźnienia, nagłówki i treści – są wysyłane na nasz serwer i tam przechowywane, razem ze zahaszowanym tokenem edycji, czasem utworzenia i ostatniego żądania oraz liczbą żądań. Żądania do Twoich endpointów obsługujemy bez zapisywania ich treści, nagłówków ani adresów IP. Mock API jest usuwane, gdy je usuniesz albo po 7 dniach bez żądania i bez edycji, a token edycji zostaje tylko w tej przeglądarce. Każdy, kto zna URL, może wywołać Twoje endpointy, więc nie umieszczaj w nich sekretów ani prawdziwych danych osobowych.

Funkcje

Prawdziwe endpointy HTTPS

Dowolna metoda, parametry w ścieżce, kody statusu od 200 do 599, opóźnienia i własne nagłówki X-.

Szablony fałszywych danych

Ponad 30 symboli zastępczych dla osób, firm, miejsc, dat, liczb i tekstu – jako pojedynczy obiekt lub lista.

Bezpieczne z założenia

Tylko JSON, włączony CORS, brak logów żądań, zahaszowany token edycji, usuwanie po 7 dniach bez użycia.

Mock REST API: najczęstsze pytania

Co jest przechowywane na Waszym serwerze i jak długo?
Przechowujemy zapisane definicje endpointów, skrót SHA-256 tokenu edycji, czas utworzenia i ostatniego wywołania mock API oraz liczbę odebranych żądań. Nie zapisujemy treści żądań, nagłówków ani adresów IP. Każde mock API jest usuwane, gdy klikniesz Usuń, albo automatycznie po 7 dniach bez żadnego żądania i edycji, więc API, z którego korzystasz, pozostaje dostępne.
Czy mogę wywołać mock API z mojej aplikacji front-endowej?
Tak. Każda odpowiedź zawiera nagłówek Access-Control-Allow-Origin ustawiony na *, a żądania wstępne OPTIONS są obsługiwane, więc fetch, axios lub dowolny klient HTTP w przeglądarce, na dowolnej domenie, także localhost, może je wywołać. Użyj bazowego URL z dopisaną ścieżką endpointu, na przykład fetch(base + "/users"). Działają też aplikacje mobilne, Postman i curl, bo endpointy to zwykłe adresy HTTPS.
Jak działają symbole zastępcze fałszywych danych?
W trybie Fałszywe dane każdy ciąg w szablonie JSON, który jest symbolem zastępczym, na przykład "{{email}}" lub "{{int(1, 100)}}", jest podmieniany po nadejściu żądania, a symbole zajmujące cały ciąg i oznaczające liczbę albo wartość true lub false stają się prawdziwymi liczbami i wartościami logicznymi JSON. Symbole mogą też stać wewnątrz tekstu, jak "Hello {{firstName}}". Ustaw rozmiar listy, aby powtórzyć szablon, a {{id}} policzy 1, 2, 3 dla kolejnych elementów.
Czy mock może zwracać błędy albo wolne odpowiedzi?
Tak. Wybierz dowolny status od 200 do 599, na przykład 401 Unauthorized, 404 Not Found, 422 dla błędów walidacji, 429 Too Many Requests lub 503, i napisz JSON błędu, jakiego oczekuje Twoja aplikacja. Opóźnienie wstrzymuje każdą odpowiedź nawet do 5 sekund w planie darmowym, co pomaga testować spinnery, limity czasu i ponawianie żądań. Odpowiedzi ze statusem 204 i 304 są wysyłane bez treści.
Dlaczego mock API nie może zwracać HTML ani ustawiać ciasteczek?
Darmowe endpointy, które zwracają dowolną treść, chętnie służą do stron phishingowych i linków z malware. Aby te mocki działały wyłącznie jako API, każda odpowiedź ma typ application/json, nagłówek nosniff i restrykcyjną politykę bezpieczeństwa treści, a dozwolone są tylko własne nagłówki zaczynające się od X-. Mocki nie ustawią więc ciasteczek, nie przekierują przeglądarki ani nie udadzą strony internetowej.