Tag Archives: worlds

TibiaData API v4 released (v4.0.0)

A long waiting is over now.. today it’s finally time some new stuff!

Today we can announce that version 4 of TibiaData API is released!

Through our API, you can have access to an API providing information of characters, guilds, highscores, worlds and a lot more of Tibia.
You can based on the request provided by us build your own clients to retrieve the information you need.

Changes of TibiaData API v4

Since v4 is not a rewrite of TibiaData like we had with v3, the changes are not as large when migrating.

Largest change to the API is the implementation of better error responses, where you don’t get a 200 OK from our servers anymore even if an error occurred. You can find all the corresponding error codes that you can encounter inside the status section.

The structures of responses is slightly different when it comes to information section, where we now include additional information as for instance release version, git commit sha, status and error codes and more.

Head over to our documentation to play around with our API and get your tools migrated to v4.

The documentation

The documentation from v4 has been swagger-generated, so you can easily generate your own TibiaData client to consume our API.

You can find the swagger.json file in our tibiadata-api-docs repository on GitHub.

There is a swagger-documentation page available on https://docs.tibiadata.com, where you can play around.

The code

As mentioned in previous blog posts, TibiaData is now publishing it’s code publicly on GitHub.

Dig around and contribute to our repo to enhance our service.

You can find all our repos under our GitHub organization here.

We’ve also bumped the GitHub release version to match the API version.

Report issues

Report to us, if you find something that is not correct.
Suggest to us, if you are missing some feature and we’ll implement it.

Thank you!

Special thanks to all our contributors to TibiaData and thanks for everyone testing and reporting issues.

Try it yourself!

Kind regards,
Tobias

TibiaData API v3 released (v3.0.0)

A long waiting is over now.. today it’s finally time some new stuff!

Today we can announce that version 3 of TibiaData API is released!

Through our API, you can have access to an API providing information of characters, guilds, highscores, worlds and a lot more of Tibia.
You can based on the request provided by us build your own clients to retrieve the information you need.

Changes of TibiaData API v3

Since v3 is a rewrite of TibiaData from PHP to Golang, the difference between v2 and v3 is larger than between v1 and v2.
Therefore we’ll not have a changelog list as we did in last release.

There have also been additions of endpoints like creatures, fansites, killstatistics and more.

Head over to our documentation to play around with our API and get your tools migrated to v3.

The documentation

The documentation from v3 has been swagger-generated, so you can easily generate your own TibiaData client to consume our API.

You can find the swagger.json file in our tibiadata-api-docs repository on GitHub.

There is a swagger-documentation page available on https://docs.tibiadata.com, where you can play around.

The code

As mentioned in previous blog posts, TibiaData is now publishing it’s code publicly on GitHub.

Dig around and contribute to our repo to enhance our service.

You can find all our repos under our GitHub organization here.

We’ve also bumped the GitHub release version to match the API version.

Upcoming improvements

We don’t have any proper error handling yet in addition to some other few minor things.

Therefore there will be some addition in the couple of days, but those will not impact you going from v2 to v3.

There will be separate blog posts when those are being added.

Report issues

Report to us, if you find something that is not correct.
Suggest to us, if you are missing some feature and we’ll implement it.

Thank you!

Special thanks to Kennedy (aka kamilon) and Pedro for the huge amount of contributions to TibiaData and thanks for everyone testing and reporting issues.

Try it yourself!

Kind regards,
Tobias

Minor changes in TibiaData API

There have been a minor change to the TibiaData API regarding the worlds views.

Bug-fixes

  • Worlds view
    • worlds with records or ongoing 999+ players have been displayed wrong.

Credits to Jakub Kulpa and who sent the report of the bug in the API.
Keep the reports coming and feel free to suggest new features too!

Regards,
Tobias

TibiaData cache intervals

I’ve received a lot of questions regarding realtime data and the cache we use on our side.. so I thought that I will give you some more details!

As from v2 of the API, we’ve implemented a cache, to minimize the resources that we use in for example CPU usage and to lower the amount of requests that poll our service on a seconds bases.
We at TibiaData understand that you want the latest latest data, but when receiving that amount of similar requests, we had to limit it somehow.

The cache we use is a memcached daemon, which stores data in the memory to serve the information faster to you.

Here is a list of the different API requests and the corresponding memcached timeouts.

  • Characters = 300 s
  • Guild/Guilds/Guildwars = 120 s
  • Highscore = 900 s
  • House/Houses = 300 s
  • News/Newslist = 900 s
  • World/Worlds = 60 s

Do you want to contribute with some money to our project? 
Here you can find our PayPal pool for TibiaData:
https://paypal.me/pools/c/7ZbFeDdXZ6

Best regards,
Tobias Lindberg

TibiaData API v2 released

Today I can announce that version 2 of TibiaData API is released!

Through our API, you can have access to an API providing information of characters, guilds, highscores, houses, news and all worlds of Tibia.
You can based on the request provided by us build your own clients to retrieve the information you need.

Changelog of TibiaData API v2

Changes compared to v1

  • Characters view
    • more details on the house
    • status flag on character itself
    • minor modifications of the json data
  • Guilds view
    • one new subrequest providing information about wars
    • adding flags
      • open / closed for applications
      • in war
      • online and offline players
      • disbanded warning
      • …
    • showing url to guild logo
    • changes to guildhall information
    • minor modifications of the json data
  • Highscores view
    • request returns all 300 top ranks on one single request
    • option to filter on vocation
    • adding keys to show filtered values at top
    • minor modifications of the json data
  • Houses view
    • new requests providing information about houses from tibia.com
  • News view
    • separation of requests for newstickers and latestnews
    • fixing a couple of formattings of html content
    • minor modifications of the json data
  • Worlds view
    • minor modifications of the json data
  • Overall changes
    • all integers should be formatted as integers instead of strings
    • requests contains version number, execution time, last updated and a timestamp
    • requests are cached on various lengths of minutes depending on what type it is
    • improvement in response time and optimizing of code

Report to us, if you find something that is not correct.
Suggest to us, if you are missing some feature and we’ll implement it.

Thanks to our testers Allan Galarzaa, Damian Busz and Stefan Ehlert and one big thanks thanks to all guys, who made any suggestions or reported issues of the previous API v1!

Try it yourself!

Regards,
Tobias

Minor changes in TibiaData API

There have been a minor change to the TibiaData API regarding the news and worlds views.

New features

  • Worlds view
    • added field BattlEye Status, Premium Type and Transfer Type, which was added to tibia.com due to an update of their page

Bug-fixes

  • News view
    • fixed url for news images, which were broken after some changes on tibia.com
  • Worlds view
    • fixed faulty date when world was created

Credits to Allan Galarzaa who sent the bugs to us.
Keep the reports coming and feel free to suggest new features too!

Regards,
Tobias

Minor changes in TibiaData API

There have been some minor changes to the TibiaData API regarding the worlds and news view.

New features

  • Worlds view
    • total online number is implemented

Bug-fixes

  • Characters view
    • character details like marriage, guilde membership and last login stopped working
  • News view
    • some news where returned blank, since formatting of spaces was corrupt
    • encoding of some strings caused call to fail
  • Highscores view
    • winter update broke call to highscores page
  • Worlds view
    • list of all worlds has been moved to an own array

Credits once again to Stefan Ehlert who reported some of the issues in the API.
Keep the reports coming and feel free to suggest new features too!

Regards,
Tobias