Files
amiibo-service/Catalogs/AmiiboService.docc/Library.md
T
javier 410a200661 GitHub Pages documentation support. (#5)
This PR contains the work done to:
* Update the `Library` article in the DocC documentation catalog in the project;
* Generate the DocC documentation of the library for GitHub Pages;
* Written the `README` file in the project.

Reviewed-on: #5
Co-authored-by: Javier Cicchelli <javier@rock-n-code.com>
Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>
2025-09-09 18:34:29 +00:00

2.1 KiB

AmiiboService

A library that provides everything the developer needs to interacts with the Amiibo API backend service.

Overview

The AmiiboService library is a Swift Package Manager package dependency aims at allowing the developer to interact with the Amiibo API online service seamlessly, by not only providing the service tye but also any possible clients, models, filters and errors type that might be needed.

Design

Although it could have been possible to generate a one-to-one RESTful client based on the Open API specification document that describe the available endpoints at the backend, it was decided to design a AmiiboService service that removes the complexities of the backend service's API design, and provides the developer with a simple interface, and a seamless experience.

Instalation

To use the AmiiboService library with your package, then add it as a dependency in the Package.swift file:

let package = Package(
    // name, platforms, products, etc.
    dependencies: [
        .package(url: "https://github.com/rock-n-code/amiibo-service", from: "1.0.0"),
        // other dependencies
    ],
    targets: [
        .target(
            name: "SomeTarget", 
            dependencies: [
                .product(name: "AmiiboService", package: "amiibo-service"),
            ]
        )
        // other targets
    ]
)

It is also possible to use the AmiiboService library with your app in Xcode, then add it as a dependency in your Xcode project:

important: Swift 5.9 or higher is required in order to compile this library.

Topics

Service

  • AmiiboService

Clients

  • AmiiboClient
  • AmiiboLiveClient
  • AmiiboMockClient

Models

  • Amiibo
  • Amiibo/Game
  • Amiibo/Platform
  • Amiibo/Release
  • Amiibo/Usage
  • AmiiboSeries
  • AmiiboType
  • GameCharacter
  • GameSeries

Filters

  • AmiiboFilter
  • AmiiboSeriesFilter
  • AmiiboTypeFilter
  • GameCharacterFilter
  • GameSeriesFilter

Errors

  • AmiiboServiceError