Что ж, я привык к этому, во-первых, вы разрабатываете API для сервиса, который должны использовать разработчики игр.Очевидно, вы должны реально реализовать сервис.:)
Следующим шагом является предоставление SDK, который дополнительно инкапсулирует API и упрощает работу с ним, устраняя семантический разрыв между API и клиентом и избавляя разработчиков от скучной работы по сортировке вызовов.и синтаксический анализ возвращаемых значений.
Вы можете предоставить SDK для использования в качестве разделяемой библиотеки времени выполнения, чтобы можно было предоставлять исправления ошибок и другие внутренние изменения, не требуя перекомпиляции и обновления.
Причинапочему я не могу согласиться с Дэниелом в том, что я не вижу выгоды от введения промежуточного уровня.Это просто еще один источник ошибок и проблем с безопасностью.Исходя из моего опыта, наиболее существенные изменения, которые я знаю в API-интерфейсах, - это устаревшие вызовы, изменение сигнатур вызовов или структуры возвращаемых данных.Поскольку вы пишете это с нуля, очень вероятно, что это произойдет.
В заключение, лучшие практики для меня:
- хорошо разработанный API
- документация
- SDK
- поддержка разработчиков
greetz
back2dos