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