Едно API за сайт и мобилно приложение: опитът от auto-data.net

Едно API за сайт и мобилно приложение: опитът от auto-data.net

auto-data.net е каталог с технически данни за над 57 000 автомобила. Има сайт на много езици, мобилно приложение за Android и iOS и платено API, през което други сайтове и програми получават данните. Всичко това работи от една база.

Една база, три начина на достъп

  • Сайтът показва данните като страници за марки, модели, поколения и модификации.
  • Приложението вика API адреси – меню, търсене, данни за кола – и получава само данните, без HTML.
  • Платеното API дава достъп на клиенти с ключове, лимити и статистика за използването.

Когато се добави нова кола или се поправи стойност, промяната се вижда навсякъде веднага. Няма втора база за приложението, която да се синхронизира.

История с езиците

Потребител от Италия писа, че е избрал италиански в приложението, но то остава на английски. Причината: на сайта списъкът с регионалните кодове на езиците беше разширен – вместо само „it“ вече имаше „it, it-IT, it-CH“. API-то на приложението търсеше точно „it“ и не го намираше.

Поправката беше кодът на езика да се нормализира на входа: „it“, „it-IT“, „it_IT“ и „it,it-IT“ се свеждат до един и същ код, а за езиците, при които кодът на сайта се различава от стандартния (например gr и el за гръцки), се проверяват и двата.

Урокът: промяна в сайта може да счупи приложението, ако двете ползват едни данни. API-то трябва да приема входа гъвкаво и да има проверки с реални устройства на различни езици.

Версии на приложението

Сайтът се обновява за всички наведнъж, приложението – не. Хората ползват стари версии месеци наред. Затова:

  • API-то остава съвместимо назад – старите версии получават данни в стария формат;
  • приложението съобщава версията си, а сървърът може да покаже съобщение за обновяване;
  • нови полета се добавят, без да се махат или преименуват старите.

Кога си струва този подход

Ако имате сайт с данни – продукти, обяви, графици, цени – и мислите за приложение, правилният първи въпрос е как ще изглежда API-то. Добре направено, то обслужва сайта, приложението и партньорите ви едновременно. Вижте мобилни приложения и уеб базиран софтуер или ни пишете.

← Всички статии

Имате идея за сайт, приложение или система?

Разкажете ни накратко какво ви трябва – ще се свържем с вас за кратък разговор и ясна оферта.

Обсъдете проектили се обадете на +359 89 575 4081