{"id":31065597,"url":"https://github.com/rock-n-code/amiibo-service","last_synced_at":"2026-04-02T11:40:02.443Z","repository":{"id":315209950,"uuid":"1058095711","full_name":"rock-n-code/amiibo-service","owner":"rock-n-code","description":"An unofficial service written in Swift that interacts with the Amiibo API backend service.","archived":false,"fork":false,"pushed_at":"2026-03-23T00:20:38.000Z","size":1655,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-23T18:12:32.635Z","etag":null,"topics":["amiibo-api","amiibos","swift-client","swift-library"],"latest_commit_sha":null,"homepage":"https://rock-n-code.github.io/amiibo-service/documentation/amiiboservice/","language":"Swift","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/rock-n-code.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":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-16T16:03:50.000Z","updated_at":"2026-03-23T00:20:41.000Z","dependencies_parsed_at":"2025-10-15T03:44:10.084Z","dependency_job_id":"60ad4ab7-4817-4325-ac5d-487aef004c18","html_url":"https://github.com/rock-n-code/amiibo-service","commit_stats":null,"previous_names":["rock-n-code/amiibo-service"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/rock-n-code/amiibo-service","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rock-n-code%2Famiibo-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rock-n-code%2Famiibo-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rock-n-code%2Famiibo-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rock-n-code%2Famiibo-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rock-n-code","download_url":"https://codeload.github.com/rock-n-code/amiibo-service/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rock-n-code%2Famiibo-service/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31305721,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T09:48:21.550Z","status":"ssl_error","status_checked_at":"2026-04-02T09:48:19.196Z","response_time":89,"last_error":"SSL_read: 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":["amiibo-api","amiibos","swift-client","swift-library"],"created_at":"2025-09-15T16:05:07.933Z","updated_at":"2026-04-02T11:40:02.431Z","avatar_url":"https://github.com/rock-n-code.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Frock-n-code%2Famiibo-service%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/rock-n-code/amiibo-service)\n[![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Frock-n-code%2Famiibo-service%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/rock-n-code/amiibo-service)\n\n# Amiibo Service\n\nA library written entirely with [Swift](https://www.swift.org) that provides everything the developer needs to interact with the [Amiibo API](https://www.amiiboapi.org) backend service.\n\n## Installation\n\nTo use this library, add it as a dependency in the `Package.swift` file:\n\n```swift\nlet package = Package(\n    // name, platforms, products, etc.\n    dependencies: [\n        .package(url: \"https://github.com/rock-n-code/amiibo-service\", from: \"1.4.1\"),\n        // other dependencies\n    ],\n    targets: [\n        .target(\n            name: \"SomeTarget\", \n            dependencies: [\n                .product(name: \"AmiiboService\", package: \"amiibo-service\"),\n            ]\n        )\n        // other targets\n    ]\n)\n```\n\nIt is also possible to use this library with your app in Xcode by adding it as a dependency in your Xcode project.\n\n\u003e [!IMPORTANT]\n\u003e Swift 5.10 or higher is required in order to build this library.\n\n## Usage\n\n```swift\nimport AmiiboService\n\nlet service = AmiiboService()\n\n// Fetch all amiibos\nlet amiibos = try await service.getAmiibos()\n\n// Fetch amiibos filtered by name\nlet zeldaAmiibos = try await service.getAmiibos(.init(name: \"zelda\"))\n\n// Fetch amiibo series, types, game characters, and game series\nlet series = try await service.getAmiiboSeries()\nlet types = try await service.getAmiiboTypes()\nlet characters = try await service.getGameCharacters()\nlet gameSeries = try await service.getGameSeries()\n\n// Fetch the last updated timestamp\nlet lastUpdated = try await service.getLastUpdated()\n```\n\n## Caching\n\nThe [Amiibo API](https://www.amiiboapi.org) recommends that consumers who call the API regularly implement caching on their systems. Pass a custom `URLSessionTransport` with a cache-configured `URLSession` to `AmiiboLiveClient`:\n\n```swift\nimport OpenAPIURLSession\n\nlet configuration = URLSessionConfiguration.default\n\nconfiguration.urlCache = URLCache(\n    memoryCapacity: 5_000_000,\n    diskCapacity: 50_000_000\n)\n\nlet transport = URLSessionTransport(\n    configuration: .init(\n        session: URLSession(configuration: configuration)\n    )\n)\n\nlet service = AmiiboService(\n    client: AmiiboLiveClient(transport: transport)\n)\n```\n\n## Testing\n\nThe `AmiiboClient` protocol enables creating custom mock clients for unit testing without network calls. Conform to `AmiiboClient` and inject it into `AmiiboService` via its `init(client:)` initializer:\n\n```swift\nimport AmiiboService\n\nstruct MyMockClient: AmiiboClient {\n    var error: AmiiboServiceError?\n\n    func getAmiibos(\n        by filter: AmiiboFilter\n    ) async throws(AmiiboServiceError) -\u003e [Amiibo] {\n        if let error { throw error }\n        return []\n    }\n\n    // Implement remaining protocol requirements...\n}\n\nlet service = AmiiboService(client: MyMockClient())\n```\n\n## Documentation\n\nPlease refer to the [online documentation](https://rock-n-code.github.io/amiibo-service/documentation/amiiboservice/) for further information about this library.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frock-n-code%2Famiibo-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frock-n-code%2Famiibo-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frock-n-code%2Famiibo-service/lists"}