Tag Archives: v2

Maintenance of our service

We have still seen a lot of requests coming in to the deprecated V2 API endpoints, which is the reason why we’ve had a grace period before terminating those requests.
But since V2 is deprecated and should have switched over the V3 by now, we’ve disabled all V2 endpoints by today 14:55 CEST.

A server restart will also take place around that time, which should only interrupt the service for around 1-2 minutes.

Kind regards,
Tobias


Maintenance of our service

Hello there,

Our hosting provider DigitalOcean will make changes in the networking equipment to improve performance and support future functionality of our hosting location.

This maintenance is expected to not have any impact on our services, except for a risk of increased latency as well as small amounts of packet loss while the upgrades are performed.

Maintenance window:
Start: 2022-05-03 16:00 UTC
End: 2022-05-03 19:00 UTC

Regards,
Tobias


Reminder regarding deprecation of the TibiaData API v2

This is just a reminder for you guys, who have missed our last post regarding the upcoming deprecation of TibiaData API v2.

In order to continue to provide great API to you all while implementing new features without breaking things, we need to deprecate the TibiaData API v2.

TibiaData API v2 will be deprecated the 30rd April 2022!

In the update the 1th March 2022, we announced the release of v3. Go check it out here.

Regards,
Tobias


Upcoming deprecation of the TibiaData API v2

In order to continue to provide great API to you all while implementing new features without breaking things, we need to deprecate the TibiaData API v2.

TibiaData API v2 will be deprecated the 30rd April 2022!

Because the changes and improvements we do can be disruptive, we provide as much advance notice as we can so that you can be ready to make any necessary transition.
So go check out the documentation for the API v3 to see, which those changes are.

In the update the 1th March 2022, we announced the release of v3. Go check it out here.

Thank you for all the support and love to our API!

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


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


Maintenance of our server

Hi there,

Today, we will migrating the API to a new platform and by that, the IP of the API will change.

The support for IPv6 is temporary removed, so the API will now only be available through IPv4.

It should not impact your except if you use the static IP instead of the DNS api.tibiadata.com in your integrations.

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