Difference between revisions of "Turf API"

(Category)
 
(6 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
 
== Disclaimer ==
 
== Disclaimer ==
  
Line 6: Line 5:
 
== Description ==
 
== Description ==
  
The Turf API is currently based on HTTP requests/responses structured as XML or RSS for ease of use and availability reasons.
+
The Turf API is currently based on HTTP requests/responses structured as JSON (in older versions XML or RSS) for ease of use and availability reasons.
 
The system is based on different versions. You can choose which version to use by stating this in the request-URL.
 
The system is based on different versions. You can choose which version to use by stating this in the request-URL.
 +
Old API versions are still available but it is NOT recommended to use them, they might not be maintained in the future.
  
Example:
+
== Examples ==
http://api.turfgame.com/v2/ will take you to API version 2, while http://api.turfgame.com/unstable/ will take you to the "unstable" version of the API.
+
http://api.turfgame.com/ will take you to the latest stable API.
 +
 
 +
http://api.turfgame.com/v2/ links to API version 2.
 +
 
 +
http://api.turfgame.com/unstable/ will take you to the "unstable" version of the API.
  
 
== Usage ==
 
== Usage ==
Line 17: Line 21:
  
 
== Versions ==
 
== Versions ==
[[TurfAPI V1]]
+
[[Turf API V1]]
 +
 
 +
[[Turf API V2]]
 +
 
 +
[[Turf API V3]]
  
[[TurfAPI V2]]
+
[[Turf API V4]] (Latest stable)
  
[[TurfAPI V3]] (Latest stable)
+
[[Unstable Turf API]] (EXPERIMENTAL, functions may be added or removed. Do not use for your final product.)
  
[[Unstable Turf API]] (EXPERIMENTAL, functions may added or removed. Do not use for your final product.)
 
  
 +
[[Category: Third Party:Tools]]
  
[[Category:Third-Party Development]]
+
[[sv:TurfAPI]]

Latest revision as of 07:20, 22 October 2020

Disclaimer[edit]

The turf API is intended for use in third party implementations. Hacking, heavy over-use or other malicious usage of the API may lead to banning from the API and the game.

Description[edit]

The Turf API is currently based on HTTP requests/responses structured as JSON (in older versions XML or RSS) for ease of use and availability reasons. The system is based on different versions. You can choose which version to use by stating this in the request-URL. Old API versions are still available but it is NOT recommended to use them, they might not be maintained in the future.

Examples[edit]

http://api.turfgame.com/ will take you to the latest stable API.

http://api.turfgame.com/v2/ links to API version 2.

http://api.turfgame.com/unstable/ will take you to the "unstable" version of the API.

Usage[edit]

Click on the API below to see how to use it. (Usage may differ between different versions.)

Versions[edit]

Turf API V1

Turf API V2

Turf API V3

Turf API V4 (Latest stable)

Unstable Turf API (EXPERIMENTAL, functions may be added or removed. Do not use for your final product.)