Tag Archives: characters

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 characters views.

Bug-fixes

  • Characters view
    • HTML changes on tibia.com broke parser (which caused disturbances)
    • first row of tables was ignored but is back again now
    • implementing support for multiple houses (replaced house with houses)
  • Houses view
    • fixing list of all houses

Credits to all 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 characters view.

New features

  • Characters view
    • character deathlist contains a list of characters that are involved in the characters death
  • Highscores view
    • list of characters contains vocation information

Bug-fixes

  • Characters view
    • character deathlist reason does now start with the tibia.com reason (slain, executed, ..)
    • character deathlist reason has a linebreak when having assisting characters in line

Credits to Stefan Ehlert who sent the suggestion for the API.
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

Minor changes in TibiaData API

There have been some minor changes to the TibiaData API on all requests.

Bug-fixes

  • Overall fix
    • JSON formatation set to run unicode on every API call
    • API request sometimes return no answer.. but we try to retrieve data multiple times before failing
  • Characters view
    • last_login value return was giving wrong formatted return
  • Guilds view
    • description was not fully working.. now the guildname is not removed within the description field

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

Minor changes in TibiaData API

There have been some minor changes to the TibiaData API regarding the character and guild view.

New features

  • Characters view
    • returns now account achievements which are displayed on official tibia homepage
    • showing other account characters include online/offline status now

Bug-fixes

  • Characters view
    • regarding account information does return faulty formatted JSON in some situations
  • Guilds view
    • regarding members is reformatted that rank titles are not keys anymore

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

Regards,
Tobias