SDK Elixir

Cette page décrit comment intégrer Coffrify en Elixir. Le package Hex est en cours de préparation et pas encore publié. En attendant, l'API REST v1 fonctionne parfaitement depuis Elixir avec Req (recommandé) ou tout autre client HTTP.

Pré-requis

Ajoutez {:req, "~> 0.5"} et {:jason, "~> 1.4"} dans votre mix.exs. Votre clé d'API démarre par cof_test_ en développement. Lisez-la depuis votre configuration (System.fetch_env!("COFFRIFY_API_KEY")) et ne la placez jamais en dur dans le code.

# mix.exs
defp deps do
  [
    {:req, "~> 0.5"},
    {:jason, "~> 1.4"}
  ]
end

Créer un transfert

api_key = System.fetch_env!("COFFRIFY_API_KEY")
 
{:ok, resp} =
  Req.post("https://api.coffrify.com/v1/transfers",
    headers: [
      {"authorization", "Bearer #{api_key}"},
      {"idempotency-key", "transfer-elixir-01"}
    ],
    json: %{
      files: [%{name: "rapport.pdf", size: 204_800, mime_type: "application/pdf"}],
      expires_in_hours: 48,
      max_downloads: 3
    }
  )
 
share_url = resp.body["share_url"]
IO.puts("Lien : #{share_url}")

Téléverser les fichiers

Après la création, envoyez chaque fichier en PUT sur l'url correspondante dans upload_urls, en reprenant exactement les headers fournis. Avec Req : Req.put!(item["url"], headers: item["headers"], body: file_bytes).

Recevoir les webhooks

Configurez un endpoint POST dans votre router Phoenix ou Plug. Vérifiez les en-têtes webhook-id, webhook-timestamp et webhook-signature selon le standard Standard Webhooks avec HMAC-SHA256 et votre secret whsec_…. Vous pouvez utiliser le plug Coffrify.Plug.VerifyWebhook inclus dans le SDK une fois publié.