Tag Archives: change

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

TibiaData API v3 release scheduled

Testing of v3 is ongoing and we are in the final stage.

Our v3 is planned to be release the 2022-03-01!

The plan is to have v2 and v3 running in parallel for a period of 2 months and v2 is supposed to be deprecated the 2022-05-01.

Head over to our documentation page on docs.tibiadata.com and start on getting your integrations working for the new version.

Join our Discord server and jump into the #v3 channel and let’s discuss there or if you experience any issues 🙂

Kind regards,
Tobias

Minor changes in TibiaData API

There have been a minor change to the TibiaData API regarding the gateway handling the requests.

Earlier, we’ve been using Nginx as handler of the requests, but we have successfully switched to Kong API Gateway instead. This is a first step into upcoming changes..

There are two things we would like to highlight so far.

  1. New headers related to caching by Kong
    API requests are cached in Kong API gateway instead of inside the application and with that there come a few benefits.
    Two new headers that are in place which could be nice for you to know more about:
    • Age – shows the age of the page in seconds (not presented if its not cached)
    • X-Cache-Status – identifies the status of the request’s proxy cache
      • Miss – the request was satisfied by being proxied upstream and parsed fresh data from tibia.com
      • Hit – the request was satisfied and served from cache
      • Bypass – the request could not be satisfied by the cache
  2. Response about page not found/no route existing
    • Earlier behavior, you where presented with a page not found page.
    • New behavior, you will either get a page not found or a JSON response saying there is no route.
    • Future change, you will later on only use JSON responses all the way.

If you want to know more, what the cache intervals are for the different endpoints, you can read our post about TibiaData cache intervals.

Please get in touch with us if you are experiencing any issues and we can try to resolve those.

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

Minor changes in TibiaData API

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

Bug-fixes

  • Highscores view
    • you do also see what filters where applied when doing the request
    • support for pagination where removed and you get a redirect to full entries list
    • listing all worlds encountered a small issue, which is fixed now

Credits to Murilo Ricci 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

Minor changes in TibiaData API

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

Bug-fixes

  • Highscores view
    • tibia.com does return more items and you can filter with more possibilities now
    • some values have been renamed like type to category

There might be some more changes coming with Summer 2020 update, that I will fix as soon as possible. 🙂

Keep the reports coming and feel free to suggest new features too!

Regards,
Tobias

Minor changes in TibiaData API

There have been a minor change to the TibiaData API regarding the guilds, houses and news views.

Bug-fixes

  • Guilds, Houses and News view
    • images are now served directly from static.tibia.com, instead from TibiaData servers

Credits to Moises Huesca who sent the report of the bug 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 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

Minor changes in TibiaData API

There have been a minor change to the whole TibiaData API regarding CORS (Cross-Origin Resource Sharing).

This means, that you now can run requests with for example ajax towards the API right from your website.

The allowed HTTP methods are GET and OPTIONS.

Cross-Origin Resource Sharing (CORS) is a mechanism that uses additional HTTP headers to tell browsers to give a web application running at one origin, access to selected resources from a different origin. A web application executes a cross-origin HTTP request when it requests a resource that has a different origin (domain, protocol, or port) from its own.

Source: https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS

Credits to a lot of you, who have requested this feature in the API.
Keep the reports coming and feel free to suggest even more new features!

Regards,
Tobias

Minor changes in TibiaData API

There have been a minor change to the TibiaData API regarding the houses view.

Bug-fixes

  • Houses view
    • beds have need rewritten from spelled to numeric values.

Credits to Lucas Zumpano 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