https://github.com/linjunpop/app_store

👩‍💻 An App Store Server API (StoreKit 2) client in Elixir.
https://github.com/linjunpop/app_store

app-store app-store-server-api elixir storekit

Last synced: 5 days ago
JSON representation

👩‍💻 An App Store Server API (StoreKit 2) client in Elixir.

• Host: GitHub
• URL: https://github.com/linjunpop/app_store
• Owner: linjunpop
• License: mit
• Created: 2021-08-19T07:46:04.000Z (about 3 years ago)
• Default Branch: main
• Last Pushed: 2023-05-01T11:20:31.000Z (over 1 year ago)
• Last Synced: 2024-04-26T05:44:52.235Z (7 months ago)
• Topics: app-store, app-store-server-api, elixir, storekit
• Language: Elixir
• Homepage:
• Size: 46.9 KB
• Stars: 15
• Watchers: 3
• Forks: 7
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# App Store

[App Store Server API](https://developer.apple.com/documentation/appstoreserverapi) client.

## Installation

The package can be installed

by adding `app_store` to your list of dependencies in `mix.exs`:

```elixir

def deps do

  [

    {:app_store, "~> 0.2.1"}

  ]

end

```

## Usage

Add the default HTTP client `AppStore.HTTPClient.DefaultClient` to the application's supervision tree:

```elixir

# lib/your_app/application.ex

def start(_type, _args) do

  children = [

    ...

    {AppStore.HTTPClient.DefaultClient, []}

  ]

  ...

end

```

Build the client:

```elixir

iex> app_store = AppStore.build()

%AppStore{

  api_config: %AppStore.API.Config{

    http_client: AppStore.HTTPClient.DefaultClient,

    json_coder: AppStore.JSON.DefaultCoder,

    server_url: "https://api.storekit.itunes.apple.com"

  },

  token_config: %AppStore.Token.Config{

    json_coder: AppStore.JSON.DefaultCoder

  }

}

```

Generate a token:

```elixir

iex> token = AppStore.Token.generate_token(

  "57246542-96fe-1a63-e053-0824d011072a",

  "com.example.testbundleid2021",

  %{

    id: "2X9R4HXF34",

    pem: "-----BEGIN PRIVATE KEY----- ..."

  }

)

"eyJhbGciOiJFUzI1NiIsImtpZCI6IjJYOVI0SFhGMzQiLCJ0eXAiOiJKV1QifQ.eyJhdWQiOiJhcHBzdG9yZWNvbm5lY3QtdjEiLCJiaWQiOiJjb20uZXhhbXBsZS50ZXN0YnVuZGxlaWQyMDIxIiwiZXhwIjoxNjI5NTA2MjQwLCJpYXQiOjE2Mjk1MDI3MDAsImlzcyI6IjU3MjQ2NTQyLTk2ZmUtMWE2My1lMDUzLTA4MjRkMDExMDcyYSIsIm5vbmNlIjoiMnFlaWc0a2wxOTQ0aHFhbmVzMDAwMGMxIn0.gYa_A7J6a6UAyBTAohf4gj28jT0k-OX1CW8cwsVGb4EewEm3owdsv6iWvzt7SutCndCBg5hPfNFWuZ0Au20HxA"

```

Get transactions history:

```elixir

iex> {:ok, %AppStore.API.Response{body: body, status: status}} =

  AppStore.API.get_transaction_history(

    app_store.api_config,

    token,

    "the-transaction-id"

  )

```

Please check [https://hexdocs.pm/app_store](https://hexdocs.pm/app_store) for a full documentation.