{"id":37016480,"url":"https://github.com/seatsio/seatsio-java","last_synced_at":"2026-01-14T01:51:49.794Z","repository":{"id":29994646,"uuid":"115428444","full_name":"seatsio/seatsio-java","owner":"seatsio","description":"The official Seats.io Java client library","archived":false,"fork":false,"pushed_at":"2025-12-03T08:49:45.000Z","size":1262,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-12-05T02:01:17.109Z","etag":null,"topics":["java","seat-picker","seatmap","seats","seats-selection","seatsio-java"],"latest_commit_sha":null,"homepage":"https://www.seats.io","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/seatsio.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2017-12-26T14:20:36.000Z","updated_at":"2025-12-03T08:49:48.000Z","dependencies_parsed_at":"2024-08-02T12:50:59.504Z","dependency_job_id":"3370bf6d-87d3-4705-bf28-f592018d32ca","html_url":"https://github.com/seatsio/seatsio-java","commit_stats":null,"previous_names":[],"tags_count":183,"template":false,"template_full_name":null,"purl":"pkg:github/seatsio/seatsio-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seatsio%2Fseatsio-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seatsio%2Fseatsio-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seatsio%2Fseatsio-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seatsio%2Fseatsio-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/seatsio","download_url":"https://codeload.github.com/seatsio/seatsio-java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/seatsio%2Fseatsio-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28408692,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T00:40:43.272Z","status":"ssl_error","status_checked_at":"2026-01-14T00:40:42.636Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5: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":["java","seat-picker","seatmap","seats","seats-selection","seatsio-java"],"created_at":"2026-01-14T01:51:49.123Z","updated_at":"2026-01-14T01:51:49.779Z","avatar_url":"https://github.com/seatsio.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# seatsio-java, the official seats.io Java SDK\n\n[![Maven Central](https://img.shields.io/maven-central/v/io.seats/seatsio-java)](https://central.sonatype.dev/namespace/io.seats)\n[![Build Status](https://img.shields.io/github/actions/workflow/status/seatsio/seatsio-java/build.yml)](https://github.com/seatsio/seatsio-java/actions/workflows/build.yml)\n\n## Installing seatsio-java\n\nseatsio-java is available in the Maven Central repository:\n\n```\n// build.gradle\ndependencies {\n  compile 'io.seats:seatsio-java:90.3.0'\n}\n\n// pom.xml\n\u003cdependency\u003e\n  \u003cgroupId\u003eio.seats\u003c/groupId\u003e\n  \u003cartifactId\u003eseatsio-java\u003c/artifactId\u003e\n  \u003cversion\u003e90.3.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nNote that v74.0.0 is the first version that's hosted on Maven Central instead of on JitPack.\n\n## Java version\n\nYou need at least Java 17 to use seatsio-java.\n\n## Versioning\n\nseatsio-java follows semver since v52.2.0.\n\n## Usage\n\n### General instructions\n\nTo use this library, you'll need to create a `SeatsioClient`:\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cWORKSPACE SECRET KEY\u003e);\n...\n```\n\nYou can find your _workspace secret key_ in the [settings section of the workspace](https://app.seats.io/workspace-settings).\n\nThe region should correspond to the region of your account:\n\n- `Region.EU`: Europe\n- `Region.NA`: North-America\n- `Region.SA`: South-America\n- `Region.OC`: Oceania\n\nIf you're unsure about your region, have a look at your [company settings page](https://app.seats.io/company-settings).\n\n### Creating a chart and an event\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\nimport seatsio.charts.Chart;\nimport seatsio.events.Event;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cWORKSPACE SECRET KEY\u003e);\nChart chart = client.charts.create();\nEvent event = client.events.create(chart.key());\nSystem.out.println(\"Created event with key \" + event.key());\n```\n\n### Booking objects\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\nimport seatsio.events.Event;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cWORKSPACE SECRET KEY\u003e);\nclient.events.book(\u003cAN EVENT KEY\u003e, Arrays.asList(\"A-1\", \"A-2\"));\n```\n\n### Releasing objects\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cWORKSPACE SECRET KEY\u003e);\nclient.events.release(\u003cAN EVENT KEY\u003e, Arrays.asList(\"A-1\", \"A-2\"));\n```\n\n### Booking objects that have been held\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cWORKSPACE SECRET KEY\u003e);\nclient.events.book(\u003cAN EVENT KEY\u003e, Arrays.asList(\"A-1\", \"A-2\"), \u003cA HOLD TOKEN\u003e);\n```\n\n### Changing object status\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cWORKSPACE SECRET KEY\u003e);\nclient.events.changeObjectStatus(\u003cAN EVENT KEY\u003e, Arrays.asList(\"A-1\", \"A-2\"), \"unavailable\");\n```\n\n### Listing all charts\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\nimport seatsio.charts.Chart;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \"\u003cWORKSPACE SECRET KEY\u003e\");\n\nStream\u003cChart\u003e charts = client.charts.listAll();\ncharts.forEach(chart -\u003e {\n  System.out.println(\"Chart \" + chart.key());\n});\n```\n\nNote: `listAll()` returns a stream, which under the hood calls the seats.io API to fetch charts page by page. So multiple API calls may be done underneath to fetch all charts.\n\n### Retrieving object category and status (and other information)\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\nimport seatsio.events.EventObjectInfo;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \"\u003cWORKSPACE SECRET KEY\u003e\");\n\nMap\u003cString, EventObjectInfo\u003e eventObjectInfos = client.events.retrieveObjectInfos(event.key(), List.of(\"A-1\", \"A-2\"));\n\nSystem.out.println(eventObjectInfos.get(\"A-1\").categoryLabel());\nSystem.out.println(eventObjectInfos.get(\"A-1\").categoryKey());\nSystem.out.println(eventObjectInfos.get(\"A-1\").status());\n\nSystem.out.println(eventObjectInfos.get(\"A-2\").categoryLabel());\nSystem.out.println(eventObjectInfos.get(\"A-2\").categoryKey());\nSystem.out.println(eventObjectInfos.get(\"A-2\").status());\n```\n\n### Listing charts page by page\n\nE.g. to show charts in a paginated list on a dashboard.\n\nEach page contains an `items` array of charts, and `nextPageStartsAfter` and `previousPageEndsBefore` properties. Those properties are the chart IDs after which the next page starts or the previous page ends.\n\n```java\n// ... user initially opens the screen ...\n\nPage\u003cChart\u003e firstPage = client.charts.listFirstPage();\nfor(Chart chart: charts.items) {\n  System.out.println(\"Chart \" + chart.key())\n}\n```\n\n```java\n// ... user clicks on 'next page' button ...\n\nPage\u003cChart\u003e nextPage = client.charts.listPageAfter(firstPage.nextPageStartsAfter);\nfor(Chart chart: charts.items) {\n  System.out.println(\"Chart \" + chart.key())\n}\n```\n\n```java\n// ... user clicks on 'previous page' button ...\n\nPage\u003cChart\u003e previousPage = client.charts.listPageBefore(nextPage.previousPageEndsBefore);\nfor(Chart chart: charts.items) {\n  System.out.println(\"Chart \" + chart.key())\n}\n```\n\n### Creating a workspace\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cCOMPANY ADMIN KEY\u003e); // company admin key can be found on https://app.seats.io/company-settings\nclient.workspaces.create(\"a workspace\");\n```\n\n### Creating a chart and an event with the company admin key\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Region;\nimport seatsio.charts.Chart;\nimport seatsio.events.Event;\n\n// company admin key can be found on https://app.seats.io/company-settings\n// workspace public key can be found on https://app.seats.io/workspace-settings\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cCOMPANY ADMIN KEY\u003e, \u003cWORKSPACE PUBLIC KEY\u003e);\nChart chart = client.charts.create();\nEvent event = client.events.create(chart.key());\nSystem.out.println(\"Created event with key \" + event.key());\n```\n\n### Listing categories\n\n```java\nimport seatsio.SeatsioClient;\nimport seatsio.Category;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \"\u003cWORKSPACE SECRET KEY\u003e\");\n\nList\u003cCategory\u003e categories = client.charts.listCategories(\"the chart key\");\ncategories.forEach(category -\u003e {\n  System.out.println(\"Category \" + category.label());\n});\n```\n\n### Updating a category\n```java\nimport seatsio.charts.CategoryKey;\nimport seatsio.charts.CategoryUpdateParams;\nimport seatsio.SeatsioClient;\n\nSeatsioClient client = new SeatsioClient(Region.EU, \"\u003cWORKSPACE SECRET KEY\u003e\");\n\nclient.charts.updateCategory(\"the chart key\", CategoryKey.of(\"the category key\"),\n  new CategoryUpdateParams(\"New label\", \"#cccccc\", false));\n```\n\n## Error handling\n\nWhen an API call results in a 4xx or 5xx error (e.g. when a chart could not be found), a SeatsioException is thrown.\n\nThis exception contains a message string describing what went wrong, and also two other properties:\n\n- `errors`: a list of errors that the server returned. In most cases, this array will contain only one element, an instance of ApiError, containing an error code and a message.\n- `requestId`: the identifier of the request you made. Please mention this to us when you have questions, as it will make debugging easier.\n\n## Rate limiting - exponential backoff\n\nThis library supports [exponential backoff](https://en.wikipedia.org/wiki/Exponential_backoff).\n\nWhen you send too many concurrent requests, the server returns an error `429 - Too Many Requests`. The client reacts to this by waiting for a while, and then retrying the request.\nIf the request still fails with an error `429`, it waits a little longer, and try again. By default this happens 5 times, before giving up (after approximately 15 seconds).\n\nWe throw a `RateLimitExceededException` (which is a subclass of `SeatsioException`) when exponential backoff eventually fails.\n\nTo change the maximum number of retries, create the `SeatsioClient` as follows:\n\n```java\nSeatsioClient client = new SeatsioClient(Region.EU, \u003cWORKSPACE SECRET KEY\u003e).maxRetries(3);\n```\n\nPassing in 0 disables exponential backoff completely. In that case, the client will never retry a failed request.\n\n## Multi-threading\n\nIt's perfectly fine to re-use an instance of `SeatsioClient` in different threads. All methods are thread-safe.\n\n## Connection pooling\n\nWe manage a connection pool under the hood, to avoid having to reconnect to the seats.io server on every call. This pool supports 200 concurrent connections.\n\nThe connection pool is shared between all instances of `SeatsioClient`.\n\nIn some cases, e.g. when you're running automated test suite against a seats.io stub, it may be useful to reset the connection pool between tests. \nTo do so, call `seatsioClient.reinitializeHttpConnectionPool()`.  \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseatsio%2Fseatsio-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fseatsio%2Fseatsio-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fseatsio%2Fseatsio-java/lists"}