Мок-API могут стать спасением для разработчиков при отсутствии реальных API.

Как вы думаете, вы можете узнать что-нибудь всего за пару секунд?

Видимо, некоторые могут. Если вам интересно, кого я имею в виду, как насчет того, чтобы заглянуть в эту умопомрачительную сцену из блокбастера Матрица?

Возможно, в будущем у нас появятся такие передовые технологии, и, как и в случае с «Нео», главным героем,мы сможем загружать в свой мозг бесчисленные навыки. и поэтому наш вид превратится в совершенно другое существо.

Таким образом, мы могли бы делать все и вся с помощью скрытой силы нашего разума, на что также намекает известный футуролог и физик Митио Каку в своей книге Будущее разума. Он предполагает, что власть пока бездействует, но она точно есть.

Чему мы собираемся научиться?

Что ж, не хочу вас разочаровывать. К сожалению, такой техники у нас пока нет. Но не беспокойтесь. Этот пост (или тот выбор сцены) — не способ сказать: «Эй, приятели, держитесь!» Однажды ты легко всему научишься».

Чтобы иметь возможность объяснить мою цель, я просто хочу обратить ваше внимание на следующий диалог между центральными персонажами в этой конкретной сцене. Давайте рассмотрим это внимательно.

Морфеус: Как я тебя победил?

Нео: ты слишком быстр.

Морфеус: ты быстрее этого. Не думай, что ты такой. Знай, что ты есть! Перестань пытаться ударить меня и ударь!»

Сегодня мы изучим (познакомимся) с новой пугающей концепцией под названием API, также известной как «Интерфейс прикладного программирования», и перестанем думать, что это сложно.

Дьявольская улыбка API

Честно говоря, когда я впервые начал изучать программирование, эта аббревиатура стала моим кошмаром. Как будто дьявол смеялся надо мной. Я знал, что должен понять концепцию как можно скорее, но по какой-то причине даже ее название поначалу звучало для меня очень чуждым, поэтому какое-то время оно мне не очень нравилось.

Со временем я смог смириться с этой концепцией и решил изучить все тонкости API. Но как я дошел до этого?

Думаю, я просто послушался совета Морфеуса и перестал воспринимать его как своего заклятого врага и решил действовать в соответствии с ним. Затем все изменилось.

Я искренне верю, что таким должно быть отношение при изучении сложных вещей. Нам нужно раз и навсегда перестать демонизировать вещи в наших умах.

Может быть, эти вещи не так страшны, и это просто наш разум играет с нами злые шутки и делает проблемы больше, чем они должны быть.

Если мы сможем это сделать, мы сможем пережить феноменальные моменты, подобные этому, в мгновение ока. Ладно, возможно, я немного преувеличиваю, но суть вы поняли.

Вам не нужно ловить пули в воздухе. Однако вы можете избавиться от ментальных барьеров, мешающих вам действовать в соответствии с решением.

Что такое API и почему они важны?

Давайте сначала придумаем базовое определение API. Аббревиатура «API» означает интерфейс прикладного программирования.

Но это мало о чем говорит, не так ли? Позвольте мне сказать это так. Это своего рода переговорщик программного обеспечения (посредник), который помогает двум приложениям общаться друг с другом.

Пример API

Вместо того, чтобы давать скучное объяснение, давайте просто поместим его в контекст и придумаем историю.

Предположим, вы живете в 80-х, а интернета нет. Звучит как кошмар, не так ли? Однако было время, когда нам приходилось решать все лично.

Так или иначе, в нашем воображаемом сценарии вы хотите отправиться в отпуск на Мальдивы. Для этого вам нужно посетить туристическое агентство, чтобы забронировать все заранее, потому что вы не можете просто появиться в модном отеле и сказать: «Эй, я здесь! Дайте мне комнату». Что ж, в конечном итоге вы можете получить комнату, но качество и комфорт не могут быть гарантированы.

Туристическое агентство поможет вам завершить бронирование, связавшись с отелем на Мальдивах и обеспечив бесперебойную работу процесса. Ну, это вроде как ваш API.

В конце концов, ваш посредник дает вам документы о бронировании после получения одобрения от другой стороны. Помните, что в 80-х не было интернета. Так что без туристического агентства вы не смогли бы справиться со всеми этими вещами самостоятельно. Слава богу, тогда у нас были туристические агентства, а сегодня есть API!

Сегодняшний сценарий

Дело в том, что в наши дни у нас есть всевозможные онлайн-агентства, и они, безусловно, имеют дело с настоящими API.

Предположим, вы проголодались, но слишком устали, чтобы отправиться в ресторан быстрого питания. В результате вы решаете заказать еду в Интернете одним щелчком мыши и, не выходя из дома, ждете, пока на экране появится меню вкусных гамбургеров.

Вот что происходит с другой стороны, когда вы размещаете свой заказ. Приложение, которое вы используете, связывается с API ресторана от вашего имени и проверяет базу данных, чтобы узнать, достаточно ли товаров на складе и доступен ли доставщик. Если все остальное есть, то ваш заказ подтвержден системой.

Что такое Rest API?

С годами развивались и API. В конце концов, это программные продукты, и передовые технологические усовершенствования должны в первую очередь затронуть их.

Современные API, такие как REST, не обременяют разработчиков, поскольку к ним легко получить доступ. Эти новые версии API стандартизированы и настроены в соответствии с потребностями своей аудитории.

Короче говоря, разработчик не может представить себе жизнь без API в современном мире, независимо от их типа. Вот почему они имеют большое значение для сообщества программистов.

Зачем нам нужны фиктивные API?

Отличный вопрос! Давайте погрузимся прямо в него. Разработчики должны проверять поток и тестировать свои продукты, чтобы убедиться, что все части работают согласованно.

Чтобы протестировать такую ​​функциональность, вы должны выполнить определенные шаги, и внедрение окончательной версии API может занять некоторое время. Что мы будем делать тем временем? Сидеть и ждать? Это не звучит как хорошая идея. Проще говоря, мы не можем ждать, пока настоящие API немедленно начнут выполнять свои функции. Они могут быть не готовы.

Пока соответствующий API не будет готов к использованию, нам нужен метод для имитации реальных API. Таким образом, фиктивные API предоставляют нам прекрасную возможность увидеть функциональные ответы, которые почти не отличаются от их реальных версий.

Короче говоря, фиктивные API дадут вам представление о возможных сценариях перед выпуском конечного продукта. Благодаря им вы можете исправить проблемные части и даже разработать лучший API для надежного взаимодействия с пользователем.

Как работают фиктивные API?

Мок-серверы обеспечивают плавный переход при использовании фиктивных API. В результате фиктивные конечные точки могут работать чудесным образом. Вы генерируете их, не требуя большого внутреннего процесса на этом пути.

Сколько существует фиктивных API?

Что ж, существует слишком много фиктивных API, и это может немного пугать новых разработчиков. Jest и Postman — два популярных приложения, о которых вы, возможно, много слышали.

Однако их функции более или менее схожи. Пока они делают свою работу, остальное, по моему скромному мнению, не так важно.

Что такое Мокапи.ио?

Это то, что мы собираемся подробно изучить в этом посте. Когда вы изучите этот, я уверен, что вы легко справитесь с остальными, поскольку каждый из них работает аналогично по сути.

Mockapi.io создает для нас надежную инфраструктуру API, чтобы мы могли создавать наши модели через заданные конечные точки. Это помогает нам проверить наличие реального API в реальном проекте.

Это бесплатно?

Через Mockapi.io вы можете бесплатно сгенерировать один проект. Другими словами, это частично бесплатно. Но это довольно удобно для пользователя, поэтому вы можете зарегистрироваться и для платной версии.

Как установить проект

Это действительно кусок пирога. Как и в случае со всеми другими платформами, все начинается с процесса регистрации. Как только вы это сделаете, вы увидите пустой экран, через который вы можете создать новый проект.

Как только вы нажмете на знак «+», вас попросят назвать ваш проект. Вы также можете ввести имена или адреса электронной почты соавторов, если таковые имеются. Если нет, просто пропустите эту часть.

Давайте просто назовем этот проект «Образец» для целей тестирования и используем слово «api» в качестве префикса. Просто нажмите «Создать», чтобы завершить процесс. Обычный адрес конечной точки будет следующим:

https://имя хоста/api/конечная точка

Однако это не тот, который вы будете использовать. Если вы посетите раздел проекта, вы увидите длинный веб-адрес, подобный этому:

Повесить там. Мы еще не закончили.

Определение конечной точки

Предположим, что мы разрабатываем простую игру о ниндзя. Как вы можете догадаться, реальный API проекта еще не готов. Должны ли мы ждать, пока он появится? Или что-то с этим делать?

Как разработчик игры, вы, вероятно, имеете представление об основных функциях наших ниндзя. Чтобы протестировать наше приложение с помощью фиктивного API, нам нужны конечные точки.

Что нам нужно для нашей игры?

Конечные точки помогают нам сформировать нового ниндзя, составить список всех воинов-ниндзя, получить информацию о них и при необходимости удалить одного или нескольких воинов из списка. Давайте проверим все эти вещи.

Сначала нажмите кнопку нового ресурса. Теперь нам нужно придумать имя для нашей конечной точки. Помните, что слово «Образец» — это просто название проекта. У этого другое предназначение. Как насчет «ниндзя» в качестве названия ресурсной части?

Это означает, что все запросы, которые мы будем делать, будут отправлены на следующий адрес. В некотором смысле это имя ресурса обозначает конечную точку, которая поможет нам получить некоторые фиктивные данные.

https://5cb4a738bbf7b50014cabbfd.mockapi.io/api/ninjas

Типы запросов

После того как вы определите имя ресурса/конечной точки, система автоматически перечислит типы запросов. Просто нажмите на кнопку рядом с типами запросов (GET, POST, DELETE, PUT), чтобы включить или выключить их в зависимости от вашего желания в вашем собственном проекте.

Построение схемы

Давайте теперь прокрутим немного вниз и внимательно посмотрим на схему. Это место, где мы определяем определенные свойства/детали наших фиктивных данных.

В нашей игре про воинов-ниндзя мы будем использовать следующие свойства: Id, Name, Image, Origin, Color, IsHighlyExperienced.

Видите первый столбец внизу? Он предназначен для этой цели. Свойство «id» особенно важно, поскольку мы сможем удалить воина или выполнить аналогичные действия с помощью его идентификаторов, когда будем тестировать что-то в нашем проекте.

Во втором столбце вам нужно выбрать параметр Faker.js. При такой настройке система будет максимально реалистично формировать данные.

Последний столбец предназначен для типа данных. Будет ли это логическое значение (да/нет модель) или это будет число? Например, если вам нужно поддельное изображение и вы выбрали «аватар» в последнем столбце, система назначит вам поддельное изображение. Как здорово!

Существует также раздел шаблона объекта, который покажет вам образец схемы JSON.

Армия воинов-ниндзя

Как только вы закончите с частью ресурсов, вы почти готовы к работе. Это означает, что вы можете заняться последними штрихами.

Теперь вы можете увидеть свой проект на экране. Прямо под заголовком «Ниндзя» вы увидите поле диапазона, где вы можете выбрать количество фиктивных предметов. В нашем случае это количество ниндзя. Допустим, нам срочно нужно 10 сильных воинов.

Сделаем ли мы этих ниндзя своими собственными?

Чтобы изменить определенные части ваших фиктивных значений, просто нажмите кнопку «данные». Таким образом, вы можете изменить их по своему усмотрению.

Например, я хочу, чтобы японский ниндзя обозначался красным цветом. Я знаю, я знаю, что это необычный цвет в этой сфере деятельности. Но если вы прочтете мою предыдущую статью, то увидите, что метод дворца памяти снова в действии. Таким образом, чем страннее детали, тем легче запомнить контекст в долгосрочной перспективе.

Я также хочу ямайского воина-ниндзя. Кто сказал, что быть ниндзя предназначено только для японцев? Можно мне также немецкого ниндзя по имени «Ганс» с цветом «орхидея»? Почему нет? Что ж, в нашей альтернативной вселенной все правила гибкие, так что дерзайте!

Шутки в сторону, я просто играю с моими фиктивными данными в этом разделе. Вам, конечно, не нужно менять данные, но если вы начинающий разработчик и у вас есть немного времени, будет весело иметь свои собственные уникальные предметы/персонажи, а не использовать какие-то заранее определенные данные JSON.

Небольшой хедз-ап

После нажатия кнопки обновления давайте теперь посмотрим на окончательную версию наших фиктивных данных. Наведите курсор на заголовок (ниндзя), щелкните правой кнопкой мыши и скопируйте ссылку.

Вот как вы можете получить фиктивный адрес данных. Однако при копировании предоставленного адреса на экран пропустите слово «конечная точка». В противном случае это не сработает.

Подведение итогов

Мок-API могут стать спасением для разработчиков при отсутствии реальных API. В начале проекта реальные данные могут быть не готовы к использованию. Так что получить помощь в создании фиктивных данных — хорошая идея.

Благодаря их полезному присутствию программистам не нужно ждать, чтобы протестировать функциональность своих продуктов, пока не появятся настоящие API и не будет доступна серверная часть.

Вместо этого они могут использовать фиктивные версии для той же цели. В этом посте я поделился с вами одним из фиктивных API. Несмотря на то, что на рынке есть много других, mockapi.io очень прост в использовании, насколько я понимаю.

Если вы заинтересованы в том, чтобы погрузиться глубже и сгенерировать свой фиктивный API, написав также немного внутреннего кода, я рекомендую вам посмотреть Учебник Ани Кубоу на YouTube по этой теме. Как обычно, она так доходчиво все объясняет, что невозможно не научиться. Попробуй. Вы не пожалеете об этом.

Помните, если есть вещи, которые бросают вам вызов, как Морфеус бросает вызов Нео в этой конкретной сцене, это совсем не плохо. Это поможет вам создать лучшую версию себя.

Теперь вы можете вычеркнуть «Изучение фиктивных API» из списка задач и просто прокричать на всю вселенную: «Итак, что дальше?»

Удачного кодирования!

«Знание — сила». — Фрэнсис Бэкон

Дополнительные материалы на PlainEnglish.io. Подпишитесь на нашу бесплатную еженедельную рассылку новостей. Подпишитесь на нас в Twitter, LinkedIn, YouTube и Discord . Заинтересованы в хакинге роста? Ознакомьтесь с разделом Схема.