Мазмұнға өту

Жалған REST API жасау

Әдісін, жолын, күйін, кідірісін және JSON мәтінін өзіңіз белгілеп немесе жалған деректер жасатып, жалған JSON endpoint жасаңыз: олар прототиптеу мен тестілеу үшін біздің серверден CORS қолдауымен беріледі.

Параметр үшін :name қолданыңыз, мысалы, /users/:id

Жауап денесі
Кідіріс0 ms

"{{fullName}}" немесе "{{int(1, 100)}}" сияқты жолдар әр сұраныста ауыстырылады.

элемент

0 болса, бір объект қайтарылады

Толтырғыштар (36)
{{id}}
1, 2, 3… тізімдегі орны
{{index}}
0, 1, 2… нөлден басталатын орны
{{uuid}}
Кездейсоқ UUID v4
{{firstName}}
Аты
{{lastName}}
Тегі
{{fullName}}
Аты-жөні
{{username}}
Кіші әріпті лақап ат
{{email}}
example.com мекенжайы
{{phone}}
Телефон нөмірі (+1 555…)
{{company}}
Компания атауы
{{jobTitle}}
Лауазым
{{street}}
Көше мекенжайы
{{city}}
Қала
{{country}}
Ел
{{countryCode}}
ISO 3166 коды
{{zip}}
5 таңбалы пошта индексі
{{domain}}
мысал домен
{{url}}
https URL
{{ipv4}}
Құжаттама ауқымындағы IPv4
{{color}}
HEX түсі
{{word}}
Бір lorem сөзі
{{words}}
words(n): n lorem сөз
{{sentence}}
Lorem сөйлемі
{{paragraph}}
Үштен бес сөйлемге дейін
{{int}}
int(min, max): бүтін сан
{{float}}
float(min, max, decimals)
{{price}}
price(min, max): екі таңбалы ондық
{{bool}}
true немесе false
{{date}}
Өткен жылдағы күн (YYYY-MM-DD)
{{datetime}}
Өткен жылдағы ISO күн-уақыты
{{futureDate}}
Келесі жылдағы күн
{{status}}
active, pending немесе inactive
{{pick}}
pick(a, b, c): нұсқалардың бірі
{{param}}
param(name): URL жолындағы мән, мысалы, :id
{{query}}
query(name): сұраныс жолындағы мән
{{null}}
JSON null
Жауап тақырыптары (міндетті емес, тек X-)
Эндпоинт: 3 / 10 · CORS қосылған JSON жауаптары
Серверімізде өңделеді · endpoint JSON мәтіні сіз жойғанша немесе 7 күн бойы сұрау түспегенше сақталадыҚалай жұмыс істейді

Жалған REST API құралын қалай қолдану керек

  1. 1

    Әр endpoint сипаттаңыз

    Әдісті таңдаңыз, /users/:id сияқты жолды теріңіз, статус кодын және баяу желіні имитациялау үшін қосымша кідірісті көрсетіңіз.

  2. 2

    Жауапты жазыңыз

    Тұрақты JSON қойыңыз немесе «Жалған дерек» режиміне ауысып, {{fullName}} сияқты толтырғыштары бар үлгіні және тізім өлшемін жазыңыз.

  3. 3

    Mock API жасаңыз

    «Mock API жасау» түймесін басып, базалық URL алыңыз: әр endpoint осы URL мен өз жолы бойынша жауап береді, CORS қосулы.

  4. 4

    Шақырып, жетілдіріңіз

    Қолданбаңыздан «Сынау», curl немесе fetch арқылы шақырыңыз, содан кейін өңдеп сақтаңыз — өзгерістер бірден қолданылады — немесе жұмыс біткен соң mock-ты жойыңыз.

Шектеулер және Pro

Тегін: бір mock API үшін 10 endpoint, дене үшін 100 KB және жалпы 512 KB, кідіріс 5 секундқа дейін, жасалатын тізім 100 элементке дейін, бір келушіге минутына 120 сұраныс, сағатына 10 жаңа mock API, сұраныссыз 7 күннен кейін жойылады.

Pro шектеулерді 50 endpoint, 1 MB дене, 30 секундтық кідіріс және 1000 элементті тізімге дейін арттырады. Pro-ны қарау

Жалған REST API туралы

Mock REST API нағыз back end әлі жоқ кезде front-end және мобильді әзірлеушілерге жұмыс істейтін endpoint береді. Әр mock API-дың /api/mock-api/m/ астында өз базалық URL мекенжайы болады, ал сіз анықтаған әр endpoint сол жерде таңдаған әдіспен, жолмен, статус кодымен, кідіріспен, тақырыптармен және JSON денесімен жауап береді. Жолда параметрлер болуы мүмкін, сондықтан /users/:id үлгісі /users/7 жолына сәйкес келеді, ал үлгі бұл мәнді {{param(id)}} арқылы қайтара алады немесе сұраныс жолын {{query(name)}} арқылы оқи алады.

Жалған дерек режимі JSON үлгісін 36 толтырғыш арқылы шынайы жауаптарға айналдырады: аттар, электрондық пошталар, компаниялар мен қалалардан бастап UUID, күндер, бағалар, диапазондағы сандар және lorem мәтініне дейін. Тізім өлшемін 100 элементке дейін қойып, массив алуға болады, сондай-ақ дерек сұраныстар арасында өзгермей (snapshot тестіне ыңғайлы) немесе әр жолы өзгеріп тұратынын таңдауға болады. 200-ден 599-ға дейінгі статус кодтары 401, 404, 429 және 503 сияқты қате жағдайларын жаттықтыруға мүмкіндік береді, ал бес секундқа дейінгі кідіріс жүктеу күйлерінің қалай жұмыс істейтінін көрсетеді.

Жауаптар әрдайым CORS тақырыптары бар JSON болады, сондықтан кез келген origin-нен браузерлер оларды шақыра алады. Mock API HTML бере алмайды, cookie орната алмайды, бағыттай алмайды, алған сұраныстарды сақтамайды және дерекқор емес: POST және PUT өздеріне жіберілгенді сақтамай, тек бапталған денеңізді қайтарады.

Құпиялылық

Endpoint-терді хостинг үшін сақтаған анықтамалар — әдістер, жолдар, статус кодтары, кідірістер, тақырыптар және денелер — хэштелген өңдеу токенімен, жасалу және соңғы сұраныс уақыттарымен және сұраныс санымен бірге біздің серверге жіберіліп, сонда сақталады. Endpoint-теріңізге түскен сұранraстарға жауап беріледі, бірақ олардың денелері, тақырыптары және IP мекенжайлары журналға жазылмайды. Mock API сіз жойғанда немесе 7 күн бойы сұраныс не өзгеріс болмаса жойылады, ал өңдеу токені тек осы браузерде сақталады. URL білетін кез келген адам endpoint-теріңізді шақыра алады, сондықтан оларға құпия деректер мен нақты жеке деректерді салмаңыз.

Мүмкіндіктер

Нағыз HTTPS endpoint-тер

Кез келген әдіс, жол параметрлері, 200-ден 599-ға дейінгі статус кодтары, кідірістер және X- арнайы тақырыптары.

Жалған дерек үлгілері

Адамдар, компаниялар, орындар, күндер, сандар және мәтін үшін 30-дан астам толтырғыш, бір объект немесе тізім ретінде.

Қауіпсіз құрылым

Тек JSON, CORS қосулы, сұраныс журналы жоқ, өңдеу токені хэштелген, пайдаланылмаса 7 күннен кейін жойылады.

Жалған REST API: жиі қойылатын сұрақтар

Серверде не сақталады және қанша уақытқа?
Біз сіз сақтаған endpoint анықтамаларын, өңдеу токеніңіздің SHA-256 хэшін, mock API-дың жасалған және соңғы рет шақырылған уақытын және алған сұраныс санын сақтаймыз. Сұраныс денелері, тақырыптары және IP мекенжайлары журналға жазылмайды. Әр mock API «Жою» түймесін басқанда немесе 7 күн бойы сұраныс не өзгеріс болмаса автоматты түрде жойылады, сондықтан қолданып жүрген API қолжетімді қалады.
Mock API-ды front-end қолданбамнан шақыруға бола ма?
Иә. Әр жауапта Access-Control-Allow-Origin мәні * болып тұрады, preflight OPTIONS сұраныстарына да жауап беріледі, сондықтан fetch, axios немесе кез келген доменнен, соның ішінде localhost-тан, кез келген браузерлік HTTP клиент шақыра алады. Базалық URL мен endpoint жолын пайдаланыңыз, мысалы fetch(base + "/users"). Endpoint-тер қарапайым HTTPS URL болғандықтан, мобильді қолданбалар, Postman және curl да жұмыс істейді.
Жалған дерек толтырғыштары қалай жұмыс істейді?
«Жалған дерек» режимінде JSON үлгісіндегі толтырғыш болатын кез келген жол, мысалы "{{email}}" немесе "{{int(1, 100)}}", сұраныс келгенде ауыстырылады, ал бүкіл жолды алатын сан және true немесе false толтырғыштары нақты JSON сандары мен логикалық мәндерге айналады. Толтырғыштар мәтін ішінде де тұра алады, мысалы "Hello {{firstName}}". Үлгіні қайталау үшін тізім өлшемін қойыңыз, {{id}} әр элементке 1, 2, 3 деп санайды.
Mock қате немесе баяу жауап қайтара ала ма?
Иә. 200-ден 599-ға дейінгі кез келген статусты таңдаңыз, мысалы 401 Unauthorized, 404 Not Found, валидация қателеріне 422, 429 Too Many Requests немесе 503, және қолданбаңыз күтетін қате JSON-ын жазыңыз. Кідіріс тегін жоспарда әр жауапты 5 секундқа дейін ұстайды, бұл spinner, timeout және қайталау логикасын тексеруге көмектеседі. 204 және 304 статустары денесіз жіберіледі.
Неге mock API HTML қайтара алмайды немесе cookie орната алмайды?
Кез келген мазмұн қайтаратын тегін хостингтегі endpoint-тер фишинг беттері мен зиянды бағдарлама сілтемелері үшін ұнамды құрал болады. Бұл mock-тар тек API ретінде пайдалы болуы үшін әр жауап application/json түрінде, nosniff және қатаң content security policy-мен беріледі, тек X- деп басталатын арнайы тақырыптарға рұқсат етіледі, сондықтан mock cookie орната алмайды, браузерді бағыттай алмайды және веб-бет болып көріне алмайды.