# Storyblok
## Installation
The [package](https://hex.pm/packages/storyblok) can be installed by adding `storyblok` to your list of dependencies in `mix.exs`:
```elixir
def deps do
[
{:storyblok, "~> 2023.12.24-beta.1"}
]
end
```
## Configuration
### Storyblok API Token
The Storyblok `token` can be configured 2 ways.
#### Application
To configure the `token` for your entire application, add the following to your config file.
```elixir
import Config
config :storyblok, token: "<TOKEN>"
```
#### Per Request
Alternatively, the `token` can be configured per request by passing `token` to `Storyblok.request`.
```elixir
"123"
|> Storyblok.Story.get()
|> Storyblok.request(token: "<TOKEN>")
```
## Caching
The default configuration is to disable caching, every request hits the Storyblok API.
Caching can be enabled by setting the follow configs.
```elixir
import Config
config :storyblok, cache: true, cache_store: MyApp.CacheModule
```
Any store can be used for caching (Redis, MemCached, etc), your application must implement the `Storyblok.Cache` behaviour.
```elixir
defmodule MyApp.CacheModule do
def fetch(key, opts) do
case MyApp.get(key, opts) do
{:ok, data} -> {:ok, data}
{:error, _reason} -> {:error, :not_found}
end
end
def set(key, value, expire_in_ms, opts) do
case MyApp.set(key, value, expire_in_ms, opts) do
{:ok, _data} -> :ok
{:error, reason} -> {:error, reason}
end
end
end
```