{"id":19725663,"url":"https://github.com/xdev-software/universe-client","last_synced_at":"2025-09-17T11:32:39.422Z","repository":{"id":103685438,"uuid":"608187460","full_name":"xdev-software/universe-client","owner":"xdev-software","description":"A simple Java client for the Universe API","archived":false,"fork":false,"pushed_at":"2024-05-20T02:58:17.000Z","size":654,"stargazers_count":0,"open_issues_count":11,"forks_count":0,"subscribers_count":2,"default_branch":"develop","last_synced_at":"2024-05-20T03:46:27.526Z","etag":null,"topics":["jcon","universe","universe-client"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xdev-software.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-01T13:58:47.000Z","updated_at":"2024-05-30T04:50:10.511Z","dependencies_parsed_at":null,"dependency_job_id":"ec80d659-e00f-46ac-8922-95f9c674849f","html_url":"https://github.com/xdev-software/universe-client","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xdev-software%2Funiverse-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xdev-software%2Funiverse-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xdev-software%2Funiverse-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xdev-software%2Funiverse-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xdev-software","download_url":"https://codeload.github.com/xdev-software/universe-client/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224191614,"owners_count":17271089,"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":["jcon","universe","universe-client"],"created_at":"2024-11-11T23:32:19.274Z","updated_at":"2025-09-17T11:32:34.136Z","avatar_url":"https://github.com/xdev-software.png","language":"Java","readme":"[![Latest version](https://img.shields.io/maven-central/v/software.xdev/universe-client?logo=apache%20maven)](https://mvnrepository.com/artifact/software.xdev/universe-client)\n[![Build](https://img.shields.io/github/actions/workflow/status/xdev-software/universe-client/check-build.yml?branch=develop)](https://github.com/xdev-software/universe-client/actions/workflows/check-build.yml?query=branch%3Adevelop)\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=xdev-software_universe-client\u0026metric=alert_status)](https://sonarcloud.io/dashboard?id=xdev-software_universe-client)\n\n# Universe client for Java\n\nA simple Java client for the [Universe API](https://developers.universe.com).\n\n## Usage\n\nThe two basic entries are the ``ApplicationId`` and the ``RedirectUri``. They **must** be set.\n\nIf these two entries are set, you need to get ``AuthorizationCode``. This is a one-time-only code, which\nyou get by calling the URL provided by ``client.getUrlToGetAuthorizationCode()``.\n\nWith this ``AuthorizationCode`` you can request a ``BearerToken``. You can can request the ``BearerToken`` only \none time with one ``AuthorizationCode``. After that the ``AuthorizationCode`` is invalidated.\nThis can be achieved with ``client.requestBearerToken()``.\nThe ``BearerToken`` can be used for all your future requests. It is usually valid for one month.\n\nIf the ``BearerToken`` is set, you can use the actual API calls.\n\n### Example\nFull example, see [Demo](universe-client-demo/src/main/java/software/xdev/Application.java).\n\n```java\nUniverseClient client = new UniverseClient(yourConfig);\n\n// Get Events\nList\u003cEvent\u003e events = client.requestEvents(hostId);\nevents.forEach(event -\u003e logger.info(\"Event: \" + event.getTitle() + \"(id:\" + event.getId() + \")\"));\n\n// Get Attendees\nList\u003cAttendee\u003e attendees = client.requestAttendeesInEvent(events.get(0).getId(), 5, 0);\n```\n\n## GraphQL\nWe are using the [Universe GraphQL API](https://developers.universe.com/docs/graphql).\nHere are some thing to help with orientation with GraphQL.\n\nYou can test requests on [Universes GraphiQL (Explorer)](https://www.universe.com/graphiql);\n\nGet Schema:\n```\n{\n  __schema {\n    queryType {\n      fields {\n        name\n      }\n    }\n  }\n}\n```\n\n## Installation\n[Installation guide for the latest release](https://github.com/xdev-software/universe-client/releases/latest#Installation)\n\n## Support\nIf you need support as soon as possible and you can't wait for any pull request, feel free to use [our support](https://xdev.software/en/services/support).\n\n## Contributing\nSee the [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to get started with our project.\n\n## Dependencies and Licenses\nView the [license of the current project](LICENSE) or the [summary including all dependencies](https://xdev-software.github.io/universe-client/dependencies)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxdev-software%2Funiverse-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxdev-software%2Funiverse-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxdev-software%2Funiverse-client/lists"}