SDK Crystal

Cette page décrit comment intégrer Coffrify en Crystal. Le SDK est hébergé sur GitHub (coffrify/coffrify-crystal) et pas encore publié sur un registre central. En attendant, l'API REST v1 fonctionne parfaitement avec HTTP::Client, inclus dans la bibliothèque standard Crystal.

Pré-requis

Crystal 1.8+ et sa bibliothèque standard suffisent pour les appels HTTP. Pour le parsing JSON, JSON.parse est intégré. Votre clé d'API démarre par cof_test_ en développement. Lisez-la depuis l'environnement : ENV["COFFRIFY_API_KEY"].

Créer un transfert

require "http/client"
require "json"
 
api_key = ENV["COFFRIFY_API_KEY"]
 
body = {
  files:            [{name: "rapport.pdf", size: 204_800, mime_type: "application/pdf"}],
  expires_in_hours: 48,
  max_downloads:    3,
}.to_json
 
headers = HTTP::Headers{
  "Authorization"   => "Bearer #{api_key}",
  "Content-Type"    => "application/json",
  "Idempotency-Key" => "transfer-crystal-01",
}
 
HTTP::Client.post("https://api.coffrify.com/v1/transfers", headers: headers, body: body) do |resp|
  data = JSON.parse(resp.body_io.gets_to_end)
  puts "Lien : #{data["share_url"]}"
end

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.

Recevoir les webhooks

Exposez un endpoint POST dans votre serveur HTTP (Kemal, Lucky, etc.). 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_….