Обновление API (анонс 19.06.2020)

Обновление API (анонс 19.06.2020)

21/06/2020 0 Автор splinterlands.ru
Поделись в любимой соц. сети!

Любой, кто напрямую использует API Splinterlands, должен принять к сведению следующие запланированные обновления и изменения. Эти обновления вступят в силу не ранее, чем через 7 дней со дня публикации. Они не должны влиять на игроков, взаимодействующих с игрой через сайт Splinterlands или мобильное веб-приложение.

Данный пост является переводом новости официального блога @splinterlands: "Splinterlands API Updates".


Прекращение использования API-интерфейсов steemmonsters.com

Разработчики будут постепенно сокращать домен steemmonsters.com для доступа к API. Мы рекомендуем всем, кто использует steemmonsters.com для вызовов API, переключиться на game-api.splinterlands.com как можно скорее.

К тому же могут быть использованы домены api.splinterlands.io и game-api.splinterlands.io, которые будут оставаться активными и актуальными.

Обратите внимание, что это изменение относится только к API доступу, и что игроки по-прежнему смогут получить доступ к игровому веб-сайту через доменное имя steemmonsters.com.


Удаление конечной точки API/tournaments/set_team_select_timer

Первоначально, когда впервые были выпущены Швейцарские турниры (anytime tournaments), то конечная точка API/tournaments/set_team_select_timer использовалась для старта следующего сражения в турнире. Это было быстро заменено sm_start_match custom_json операцией, чтобы эти данные были доступны в блокчейне.

Для операции sm_start_match требуется тот же параметр id, что и для конечной точки /tournaments/set_team_select_timer, которую она заменяет; для начала необходимо установить идентификатор очереди битвы турнирной битвы. Пример данных JSON для операции sm_start_match :

{"id": "sm_ZLhFvZnNlbiOqFem8t6K"}

Разработчики заметили, что ряд сценариев по-прежнему используют конечную точку /tournaments/set_team_select_timer, поэтому им потребуется обновить публикацию операции sm_start_match в блокчейне Hive, прежде чем эти изменения вступят в силу.


Удаление префикса из имен операций

Хотя для всех связанных с игрой операций, публикуемых в блокчейне, перед именем операции требуется префикс sm_, конечные точки API показывают имя операции в свойстве type без префикса для некоторых новых операций в игре.

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

Это изменение будет применяться только к данным, возвращаемым конечными точками API, такими как /transactions/lookup и /transactions/history. Операции, опубликованные в блокчейне, все равно должны будут включать префикс sm_ в идентификатор всех операций, как и обычно.

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


Поделись в любимой соц. сети!