{"id":18780017,"url":"https://github.com/vrchatapi/vrchatapi-java","last_synced_at":"2025-04-13T11:30:42.191Z","repository":{"id":91103549,"uuid":"398903273","full_name":"vrchatapi/vrchatapi-java","owner":"vrchatapi","description":"🔴 VRChat API Library for Java","archived":false,"fork":false,"pushed_at":"2024-04-29T22:00:19.000Z","size":1987,"stargazers_count":9,"open_issues_count":1,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-05-01T11:26:20.380Z","etag":null,"topics":["api","java","vrchat","vrchatapi"],"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/vrchatapi.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":"2021-08-22T21:18:03.000Z","updated_at":"2024-05-27T21:30:09.040Z","dependencies_parsed_at":"2024-04-14T23:30:38.565Z","dependency_job_id":"85af3249-aa6b-49e6-b14d-c08dd4ca6f58","html_url":"https://github.com/vrchatapi/vrchatapi-java","commit_stats":null,"previous_names":[],"tags_count":29,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vrchatapi%2Fvrchatapi-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vrchatapi%2Fvrchatapi-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vrchatapi%2Fvrchatapi-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vrchatapi%2Fvrchatapi-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vrchatapi","download_url":"https://codeload.github.com/vrchatapi/vrchatapi-java/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248705481,"owners_count":21148545,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","java","vrchat","vrchatapi"],"created_at":"2024-11-07T20:24:16.182Z","updated_at":"2025-04-13T11:30:42.174Z","avatar_url":"https://github.com/vrchatapi.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](https://github.com/vrchatapi/vrchatapi.github.io/blob/main/static/assets/img/lang/lang_java_banner_1500x300.png?raw=true)\n\n# VRChat API Library for Java\n\nA Java client to interact with the unofficial VRChat API. Supports all REST calls specified in the [API specification](https://github.com/vrchatapi/specification).\n\n## Disclaimer\n\nThis is the official response of the VRChat Team (from Tupper more specifically) on the usage of the VRChat API.\n\n\u003e Use of the API using applications other than the approved methods (website, VRChat application) are not officially supported. You may use the API for your own application, but keep these guidelines in mind:\n\u003e * We do not provide documentation or support for the API.\n\u003e * Do not make queries to the API more than once per 60 seconds.\n\u003e * Abuse of the API may result in account termination.\n\u003e * Access to API endpoints may break at any given time, with no warning.\n\nAs stated, this documentation was not created with the help of the official VRChat team. Therefore this documentation is not an official documentation of the VRChat API and may not be always up to date with the latest versions. If you find that a page or endpoint is not longer valid please create an issue and tell us so we can fix it.\n\n## Getting Started\n\nFirst add the package to to your project:\n```xml\n\u003crepositories\u003e\n  \u003crepository\u003e\n    \u003cid\u003ejitpack.io\u003c/id\u003e\n    \u003curl\u003ehttps://jitpack.io\u003c/url\u003e\n  \u003c/repository\u003e\n\u003c/repositories\u003e\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.github.vrchatapi\u003c/groupId\u003e\n  \u003cartifactId\u003evrchatapi-java\u003c/artifactId\u003e\n  \u003cversion\u003emain-SNAPSHOT\u003c/version\u003e\n  \u003cscope\u003ecompile\u003c/scope\u003e\n\u003c/dependency\u003e\n```\nor\n```groovy\nallprojects {\n  repositories {\n    ...\n    maven { url 'https://jitpack.io' }\n  }\n}\ndependencies {\n  implementation 'com.github.vrchatapi:vrchatapi-java:main-SNAPSHOT'\n}\n```\n\nBelow is an example on how to login to the API and fetch your own user information.\n\n```java\n\t\t// Step 1. VRChat consists of several API's\n// e.g. (WorldsApi, UsersApi, FilesApi, NotificationsApi, FriendsApi, etc...)\n// Here we instantiate the Authentication API which is required for logging in.\nApiClient defaultClient = Configuration.getDefaultApiClient();\nAuthenticationApi authApi = new AuthenticationApi(defaultClient);\n\n// Step 2. We begin with creating a Configuration\n// This contains the username and password for authentication, as well as a user agent.\nHttpBasicAuth authHeader = (HttpBasicAuth) defaultClient.getAuthentication(\"authHeader\");\nauthHeader.setUsername(\"username\");\nauthHeader.setPassword(\"password\");\ndefaultClient.setUserAgent(\"ExampleProgram/0.0.1 my@email.com\");\n\n\n// Step 3. Call getCurrentUser on Authentication API.\nBufferedReader reader = new BufferedReader( new InputStreamReader( System.in ) );\ntry {\n    authApi.getCurrentUser();\n}\ncatch (IllegalArgumentException e){\n    // Step 4. Verify using 2fa.\n    if (e.toString().contains(\"emailOtp\")){\n        System.out.println(\"2FA Email code:\");\n        TwoFactorEmailCode code = new TwoFactorEmailCode();\n        code.setCode(reader.readLine());\n        authApi.verify2FAEmailCode(code);\n    } else {\n        System.out.println(\"2FA Authenticator code:\");\n        TwoFactorAuthCode code = new TwoFactorAuthCode();\n        code.setCode(reader.readLine());\n        authApi.verify2FA(code);\n    }\n}\n\nCurrentUser user = authApi.getCurrentUser();\nSystem.out.println(\"Logged in as: \" + user.getDisplayName());\n```\n\nSee [examples](https://github.com/vrchatapi/vrchatapi-java/blob/master/examples) for more example usage on getting started.\n\n## Contributing\n\nContributions are welcome, but do not add features that should be handled by the OpenAPI specification.\n\nJoin the [Discord server](https://discord.gg/Ge2APMhPfD) to get in touch with us.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvrchatapi%2Fvrchatapi-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvrchatapi%2Fvrchatapi-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvrchatapi%2Fvrchatapi-java/lists"}