# jsonapi-http-retry

Retry failed jsonapi requests with retry policies.

It uses the [`Retry` package](https://package.elm-lang.org/packages/choonkeat/elm-retry/latest/) and the [`jsonapi-http` package](https://package.elm-lang.org/packages/calions-app/jsonapi-http/latest/) under the hood.

With this package you can add [`retry`](https://package.elm-lang.org/packages/choonkeat/elm-retry/latest/) policies to [`jsonapi-http`](https://package.elm-lang.org/packages/calions-app/jsonapi-http/latest/) requests errors.
You can choose specific errors that will trigger a retry: unauthenticated error, network error, etc...

## Getting Started

Here is an example retrying requests 5 times maximum with a constant interval between retries, only for unauthenticated and unauthorized errors:

```elm
import Http.Request
import Http.Retry
import Json.Encode
import JsonApi.Decode
import Retry

request : Cmd Msg
request =
    Request.request
        { url = "http://endpoint"
        , headers = []
        , body = Json.Encode.object []
        , documentDecoder = JsonApi.Decode.resources "resource-type" entityDecoder
        }
        |> Http.Retry.with
            [ Retry.maxRetries 5
            , Retry.exponentialBackoff { interval = 500, maxInterval = 3000 }
            ]
            [ Http.Retry.onUnauthenticatedStatus
            , Http.Retry.onUnauthorizedStatus
            ]
        |> Task.perform OnTaskCompleted
```