{"id":21010751,"url":"https://github.com/fabiogaming/jartilities","last_synced_at":"2026-05-12T16:31:04.710Z","repository":{"id":135311472,"uuid":"512313781","full_name":"FabioGaming/JARtilities","owner":"FabioGaming","description":"An unofficial Java Wrapper for Artilities REST API","archived":false,"fork":false,"pushed_at":"2022-09-17T23:14:15.000Z","size":24,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-13T15:43:24.909Z","etag":null,"topics":["api","api-wrapper","art","artilities","java","package","rest","rest-api","rest-wrapper","wrapper"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FabioGaming.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-07-10T00:40:59.000Z","updated_at":"2023-02-18T17:30:58.000Z","dependencies_parsed_at":null,"dependency_job_id":"aef322b6-289d-4bb1-9d3b-db281030bbd8","html_url":"https://github.com/FabioGaming/JARtilities","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/FabioGaming/JARtilities","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FabioGaming%2FJARtilities","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FabioGaming%2FJARtilities/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FabioGaming%2FJARtilities/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FabioGaming%2FJARtilities/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FabioGaming","download_url":"https://codeload.github.com/FabioGaming/JARtilities/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FabioGaming%2FJARtilities/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32947478,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-12T09:19:52.626Z","status":"ssl_error","status_checked_at":"2026-05-12T09:17:33.438Z","response_time":102,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","api-wrapper","art","artilities","java","package","rest","rest-api","rest-wrapper","wrapper"],"created_at":"2024-11-19T09:23:31.135Z","updated_at":"2026-05-12T16:31:04.683Z","avatar_url":"https://github.com/FabioGaming.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# JARtilities\nAn unofficial Java Wrapper for the [Artilities REST API](https://artilities.github.io/artilities-api/)\n\n# What can this Wrapper do?\nThis wrapper currently supports `getting an Idea`, `Getting a challenge Idea`, `Looking up artist slang`, `getting Atilities Banners`. The other API functions like `getting patreons` will hopefully follow soon.\n\n# Where can I get the Wrapper?\nYou can grab the latest release from this github page!\n\n# How to Install\n1. Navigate to Releases and download the latest version of JARtilities\n2. Open Your Project in any Java IDE (my example: IntelliJ)\n3. Head to File \u003e Project Structure\n![image](https://user-images.githubusercontent.com/61352968/181909743-638fee75-74e0-40e7-ace4-145a59282080.png)\n4. Go to Library and click the + sign, then proceed to click on Java\n![image](https://user-images.githubusercontent.com/61352968/181909783-42cf0ff8-9f2b-4950-b6f6-524ba6ad8a56.png)\n5. Select JARtilities.jar and click OK\n6. After it's added to the list you can click Apply\n7. That's it.\n\n# DOCUMENTATION\n### Getting an Idea\nYou can get a random Idea from the Artilities Database using the `getIdea()` function, this function will return a HashMap with the following keys: `english`, `executionTime`, `statusCode`, `russian`, `raw`, `WebResponseCode`.\n- `english` - Will return a random Idea in english\n- `russian` - Will return a random Idea in russian\n- `executionTime` - Will return the amount of time it took the server to respond (in ms).\n- `statusCode` - Will return the Servers response code (in best case `200`).\n- `WebResponseCode` - Will return the response code of the request itself (in best case it matches `statusCode`)\n- `raw` - Will return the raw JSON output of the server\n#### Note\n- If there was an error during the request, the HashMap will return `null`\n- You might need to change your encoding to display `russian`\n#### Example Usage:\n```Java\n        HashMap\u003cString,String\u003e testMap = Artilities.getIdea();\n        if(testMap != null) {\n\n            System.out.println(\"Your Idea: \" + testMap.get(\"english\"));\n            System.out.println(\"Russian: \" + testMap.get(\"russian\"));\n            System.out.println(\"Server Response \" + testMap.get(\"statusCode\"));\n            System.out.println(\"Server Response Time: \" + testMap.get(\"executionTime\") + \"ms\");\n            System.out.println(\"Raw JSON: \" + testMap.get(\"raw\"));\n        } else {\n            System.out.println(\"There was an error during the request.\");\n        }   \n```\n#### Output:\n```\nYour Idea: God of gambling\nRussian: Бог азартных игр\nServer Response 200\nServer Response Time: 136ms\nRaw JSON: {\"status_code\":200,\"generated_idea\":{\"ru\":\"Бог азартных игр\",\"eng\":\"God of gambling\"},\"execution_time\":136}\n```\n\n### Getting a challenge\nYou can get a random Challenge from Artilities Database using the `getChallenge()` function, this function will return a HashMap with the following keys: `english`, `executionTime`, `statusCode`, `russian`, `raw`, `WebResponseCode`.\n- `english` - Will return a random Idea in english\n- `russian` - Will return a random Idea in russian\n- `executionTime` - Will return the amount of time it took the server to respond (in ms).\n- `statusCode` - Will return the Servers response code (in best case `200`).\n- `WebResponseCode` - Will return the response code of the request itself (in best case it matches `statusCode`)\n- `raw` - Will return the raw JSON output of the server\n#### Note\n- If there was an error during the request, the HashMap will return `null`\n- You might need to change your encoding to display `russian`\n- #### Example Usage:\n```Java\n        HashMap\u003cString,String\u003e testMap = Artilities.getChallenge();\n        if(testMap != null) {\n\n            System.out.println(\"Your Challenge: \" + testMap.get(\"english\"));\n            System.out.println(\"Russian: \" + testMap.get(\"russian\"));\n            System.out.println(\"Server Response \" + testMap.get(\"statusCode\"));\n            System.out.println(\"Server Response Time: \" + testMap.get(\"executionTime\") + \"ms\");\n            System.out.println(\"Raw JSON: \" + testMap.get(\"raw\"));\n        } else {\n            System.out.println(\"There was an error during the request.\");\n        }\n```\n#### Output:\n```\nYour Challenge: Generate a palette and make a drawing with these colors but in negative\nRussian: Сгенерируй палитру и выполни работу в сгенерированных цветах, но в негативе\nServer Response 200\nServer Response Time: 24ms\nRaw JSON: {\"status_code\":200,\"generated_challenge\":{\"eng\":\"Generate a palette and make a drawing with these colors but in negative\",\"ru\":\"Сгенерируй палитру и выполни работу в сгенерированных цветах, но в негативе\"},\"execution_time\":24}\n```\n### Looking up artist slang on the Artilities Database\nYou can look up artist slang from the Artilities Database using the `getDictionaryEntry()` function, this function will return a HashMap with the following keys: `term`, `desription`, `statusCode`, `executionTime`, `WebResponseCode`, `raw`.\n- `term` - Will return the result term\n- `description` - Will return the meaning / description of the searched term \n- `executionTime` - Will return the amount of time it took the server to respond (in ms).\n- `statusCode` - Will return the Servers response code (in best case `200`).\n- `WebResponseCode` - Will return the response code of the request itself (in best case it matches `statusCode`)\n- `raw` - Will return the raw JSON output of the server\n#### Note\n- If there was an error during the request, the HashMap will return `null`\n- If no result was found, `term` and `description` will return `null`\n- `getDictionaryEntry()` requires a String as  argument input.\n#### Example Usage:\n```Java\n        HashMap\u003cString,String\u003e testMap = Artilities.getDictionaryEntry(\"UFO\"); //In this case im looking up the term \"UFO\" which means \"up for offers\"\n        if(testMap != null) {\n            if(testMap.get(\"term\") != null) {\n                System.out.println(\"Your term: \" + testMap.get(\"term\"));\n                System.out.println(\"Description: \" + testMap.get(\"description\"));\n                System.out.println(\"Server Response \" + testMap.get(\"statusCode\"));\n                System.out.println(\"Server Response Time: \" + testMap.get(\"executionTime\") + \"ms\");\n                System.out.println(\"Raw JSON: \" + testMap.get(\"raw\"));\n            } else {\n                System.out.println(\"No term found for given query.\");\n            }\n\n        } else {\n            System.out.println(\"There was an error during the request.\");\n        }\n```\n#### Output:\n```\nYour term: UFO\nDescription: Short for Up For Offers.\nServer Response 200\nServer Response Time: 52ms\nRaw JSON: {\"status_code\":200,\"query_results\":[[\"UFO\",\"Short for Up For Offers.\"]],\"execution_time\":52}\n```\n### Get Artilities Banners\nYou can get Artilities Banners using the `getBanners()` function, this function will return a HashMap with the following keys: `bannerLink`, `bannerImage`, `language`, `raw`, `executionTime`, `statusCode`, `WebResponseCode`.\n- `language` - Will return the language of the banner (usually \"\")\n- `bannerImage` - Will return the link of the banner Image\n- `bannerLink` - Will return the link the banner is linked to\n- `executionTime` - Will return the amount of time it took the server to respond (in ms).\n- `statusCode` - Will return the Servers response code (in best case `200`).\n- `WebResponseCode` - Will return the response code of the request itself (in best case it matches `statusCode`)\n- `raw` - Will return the raw JSON output of the server\n#### Note\n- If there was an error during the request, the HashMap will return `null`\n- `getBanners()` is not part if the `main` functions of the API, which is why the wrapper marks it as `other`, meaning to use `getBanners()` you need to use `Artilities.other.getBanners()`\n#### Example Usage\n```Java\n        HashMap\u003cString,String\u003e testMap = Artilities.other.getBanners();\n        if(testMap != null) {\n            System.out.println(\"Banner Image: \" + testMap.get(\"bannerImage\"));\n            System.out.println(\"Banner Link: \" + testMap.get(\"bannerLink\"));\n            System.out.println(\"Server Response \" + testMap.get(\"statusCode\"));\n            System.out.println(\"Server Response Time: \" + testMap.get(\"executionTime\") + \"ms\");\n            System.out.println(\"Raw JSON: \" + testMap.get(\"raw\"));\n        } else {\n            System.out.println(\"There was an error during the request.\");\n        }\n```\n#### Output:\n```\nBanner Image: https://i.imgur.com/pKmfznm.gif\nBanner Link: https://discord.com/invite/u7dBmKyMWa\nServer Response 200\nServer Response Time: 54ms\nRaw JSON: {\"status_code\":200,\"details\":{\"banner_url\":\"https://discord.com/invite/u7dBmKyMWa\",\"banner_image\":\"https://i.imgur.com/pKmfznm.gif\",\"language\":\"\"},\"execution_time\":54}\n```\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabiogaming%2Fjartilities","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffabiogaming%2Fjartilities","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffabiogaming%2Fjartilities/lists"}