Едно 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-то. Добре направено, то обслужва сайта, приложението и партньорите ви едновременно. Вижте мобилни приложения и уеб базиран софтуер или ни пишете.