/app_store

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

Primary LanguageElixirMIT LicenseMIT

App Store

App Store Server API client.

Installation

The package can be installed by adding app_store to your list of dependencies in mix.exs:

def deps do
  [
    {:app_store, "~> 0.1.0"}
  ]
end

Usage

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

# lib/your_app/application.ex
def start(_type, _args) do
  children = [
    ...
    {AppStore.HTTPClient.DefaultClient, []}
  ]

  ...
end

Build the client:

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:

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:

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 for a full documentation.