Skip to content

dofusdude/dofusdude-java

Repository files navigation

dofusdude-java

dofusdude

  • API version: 0.9.4
    • Build date: 2024-10-21T20:57:15.239787910Z[Etc/UTC]
    • Generator version: 7.10.0-SNAPSHOT

A project for you - the developer.

The all-in-one toolbelt for your next Ankama related project.

Client SDKs

  • Javascript npm i dofusdude-js --save
  • Typescript npm i dofusdude-ts --save
  • Go go get -u github.com/dofusdude/dodugo
  • Python pip install dofusdude
  • PHP
  • Java Maven with GitHub packages setup

Everything, including this site, is generated out of the Docs Repo. Consider it the Single Source of Truth. If there is a problem with the SDKs, create an issue there.

Your favorite language is missing? Please let me know!

Main Features

  • 🥷 Seamless Auto-Update load data in the background when a new Dofus version is released and serving it within 10 minutes with atomic data source switching. No downtime and no effects for the user, just always up-to-date.

  • Blazingly Fast all data in-memory, aggressive caching over short time spans, HTTP/2 multiplexing, written in Go, optimized for low latency, hosted on bare metal in 🇩🇪.

  • 📨 Discord Integration Ankama related RSS and Almanax feeds to post to Discord servers with advanced features like filters or mentions. Use the endpoints as a dev or the official Web Client as a user.

  • 🩸 Dofus 2 Beta from stable to bleeding edge by replacing /dofus2 with /dofus2beta.

  • 🗣️ Multilingual supporting en, fr, es, pt including the dropped languages from the Dofus website de and it.

  • 🧠 Search by Relevance allowing typos in name and description, handled by language specific text analysis and indexing.

  • 🕵️ Complete actual data from the game including items invisible to the encyclopedia like quest items.

  • 🖼️ HD Images rendering game assets to high-res images with up to 800x800 px.

... and much more on the Roadmap on my Discord.

For more information, please visit https://discord.gg/3EtHskZD8h

Automatically generated by the OpenAPI Generator

Requirements

Building the API client library requires:

  1. Java 1.8+
  2. Maven (3.8.3+)/Gradle (7.2+)

Installation

To install the API client library to your local Maven repository, simply execute:

mvn clean install

To deploy it to a remote Maven repository instead, configure the settings of the repository and execute:

mvn clean deploy

Refer to the OSSRH Guide for more information.

Maven users

Add this dependency to your project's POM:

<dependency>
  <groupId>com.dofusdude</groupId>
  <artifactId>dofusdude-java</artifactId>
  <version>0.9.4</version>
  <scope>compile</scope>
</dependency>

Gradle users

Add this dependency to your project's build file:

  repositories {
    mavenCentral()     // Needed if the 'dofusdude-java' jar has been published to maven central.
    mavenLocal()       // Needed if the 'dofusdude-java' jar has been published to the local maven repo.
  }

  dependencies {
     implementation "com.dofusdude:dofusdude-java:0.9.4"
  }

Others

At first generate the JAR by executing:

mvn clean package

Then manually install the following JARs:

  • target/dofusdude-java-0.9.4.jar
  • target/lib/*.jar

Getting Started

Please follow the installation instruction and execute the following Java code:

// Import classes:
import com.dofusdude.client.ApiClient;
import com.dofusdude.client.ApiException;
import com.dofusdude.client.Configuration;
import com.dofusdude.client.model.*;
import com.dofusdude.client.api.AlmanaxApi;

public class Example {
  public static void main(String[] args) {
    ApiClient defaultClient = Configuration.getDefaultApiClient();
    defaultClient.setBasePath("https://api.dofusdu.de");

    AlmanaxApi apiInstance = new AlmanaxApi(defaultClient);
    String language = "en"; // String | code
    LocalDate date = LocalDate.parse("Tue Jul 14 00:00:00 UTC 2020"); // LocalDate | yyyy-mm-dd
    try {
      AlmanaxEntry result = apiInstance.getAlmanaxDate(language, date);
      System.out.println(result);
    } catch (ApiException e) {
      System.err.println("Exception when calling AlmanaxApi#getAlmanaxDate");
      System.err.println("Status code: " + e.getCode());
      System.err.println("Reason: " + e.getResponseBody());
      System.err.println("Response headers: " + e.getResponseHeaders());
      e.printStackTrace();
    }
  }
}

Documentation for API Endpoints

All URIs are relative to https://api.dofusdu.de

Class Method HTTP request Description
AlmanaxApi getAlmanaxDate GET /dofus2/{language}/almanax/{date} Single Almanax Date
AlmanaxApi getAlmanaxRange GET /dofus2/{language}/almanax Almanax Range
ConsumablesApi getAllItemsConsumablesList GET /{game}/{language}/items/consumables/all List All Consumables
ConsumablesApi getItemsConsumablesList GET /{game}/{language}/items/consumables List Consumables
ConsumablesApi getItemsConsumablesSearch GET /{game}/{language}/items/consumables/search Search Consumables
ConsumablesApi getItemsConsumablesSingle GET /{game}/{language}/items/consumables/{ankama_id} Single Consumables
CosmeticsApi getAllCosmeticsList GET /{game}/{language}/items/cosmetics/all List All Cosmetics
CosmeticsApi getCosmeticsList GET /{game}/{language}/items/cosmetics List Cosmetics
CosmeticsApi getCosmeticsSearch GET /{game}/{language}/items/cosmetics/search Search Cosmetics
CosmeticsApi getCosmeticsSingle GET /{game}/{language}/items/cosmetics/{ankama_id} Single Cosmetics
EquipmentApi getAllItemsEquipmentList GET /{game}/{language}/items/equipment/all List All Equipment
EquipmentApi getItemsEquipmentList GET /{game}/{language}/items/equipment List Equipment
EquipmentApi getItemsEquipmentSearch GET /{game}/{language}/items/equipment/search Search Equipment
EquipmentApi getItemsEquipmentSingle GET /{game}/{language}/items/equipment/{ankama_id} Single Equipment
GameApi getGameSearch GET /{game}/{language}/search Game Search
GameApi getItemsAllSearch GET /{game}/{language}/items/search Search All Items
MetaApi getGameSearchTypes GET /dofus2/meta/search/types Available Game Search Types
MetaApi getItemTypes GET /dofus2/meta/items/types Available Item Types
MetaApi getMetaAlmanaxBonuses GET /dofus2/meta/{language}/almanax/bonuses Available Almanax Bonuses
MetaApi getMetaAlmanaxBonusesSearch GET /dofus2/meta/{language}/almanax/bonuses/search Search Available Almanax Bonuses
MetaApi getMetaElements GET /dofus2/meta/elements Effects and Condition Elements
MetaApi getMetaVersion GET /dofus2/meta/version Game Version
MountsApi getAllMountsList GET /{game}/{language}/mounts/all List All Mounts
MountsApi getMountsList GET /{game}/{language}/mounts List Mounts
MountsApi getMountsSearch GET /{game}/{language}/mounts/search Search Mounts
MountsApi getMountsSingle GET /{game}/{language}/mounts/{ankama_id} Single Mounts
QuestItemsApi getAllItemsQuestList GET /{game}/{language}/items/quest/all List All Quest Items
QuestItemsApi getItemQuestSingle GET /{game}/{language}/items/quest/{ankama_id} Single Quest Items
QuestItemsApi getItemsQuestList GET /{game}/{language}/items/quest List Quest Items
QuestItemsApi getItemsQuestSearch GET /{game}/{language}/items/quest/search Search Quest Items
ResourcesApi getAllItemsResourcesList GET /{game}/{language}/items/resources/all List All Resources
ResourcesApi getItemsResourceSearch GET /{game}/{language}/items/resources/search Search Resources
ResourcesApi getItemsResourcesList GET /{game}/{language}/items/resources List Resources
ResourcesApi getItemsResourcesSingle GET /{game}/{language}/items/resources/{ankama_id} Single Resources
SetsApi getAllSetsList GET /{game}/{language}/sets/all List All Sets
SetsApi getSetsList GET /{game}/{language}/sets List Sets
SetsApi getSetsSearch GET /{game}/{language}/sets/search Search Sets
SetsApi getSetsSingle GET /{game}/{language}/sets/{ankama_id} Single Sets
WebhooksApi deleteWebhooksAlmanaxId DELETE /webhooks/almanax/{id} Unregister Almanax Hook
WebhooksApi deleteWebhooksRssId DELETE /webhooks/rss/{id} Unregister RSS Hook
WebhooksApi deleteWebhooksTwitterId DELETE /webhooks/twitter/{id} Unregister Twitter Hook
WebhooksApi getMetaWebhooksAlmanax GET /meta/webhooks/almanax Get Almanax Hook Metainfo
WebhooksApi getMetaWebhooksRss GET /meta/webhooks/rss Get RSS Hook Metainfo
WebhooksApi getMetaWebhooksTwitter GET /meta/webhooks/twitter Get Twitter Hook Metainfo
WebhooksApi getWebhooksAlmanaxId GET /webhooks/almanax/{id} Get Almanax Hook
WebhooksApi getWebhooksRssId GET /webhooks/rss/{id} Get RSS Hook
WebhooksApi getWebhooksTwitterId GET /webhooks/twitter/{id} Get Twitter Hook
WebhooksApi postWebhooksAlmanax POST /webhooks/almanax Register Almanax Hook
WebhooksApi postWebhooksRss POST /webhooks/rss Register RSS Hook
WebhooksApi postWebhooksTwitter POST /webhooks/twitter Register Twitter Hook
WebhooksApi putWebhooksAlmanaxId PUT /webhooks/almanax/{id} Update Almanax Hook
WebhooksApi putWebhooksRssId PUT /webhooks/rss/{id} Update RSS Hook
WebhooksApi putWebhooksTwitterId PUT /webhooks/twitter/{id} Update Twitter Hook

Documentation for Models

Documentation for Authorization

Endpoints do not require authorization.

Recommendation

It's recommended to create an instance of ApiClient per thread in a multithreaded environment to avoid any potential issues.

Author

stelzo@steado.de