API Send : tous les outils, accessibles en REST

Quickstart en 4 étapes

1. 1. Créer un compte tenant

   Signup gratuit 30 jours sur l'apex pour obtenir un sous-domaine {slug}.sudinformatique.com.

2. 2. Générer un token Sanctum

   Depuis la console tenant → Paramètres → API tokens, créez un token avec les abilities nécessaires (tools:execute, files:read, etc.).

   # Stockez votre token (commence par "1|..." ou "2|...")
   export SEND_TOKEN="1|abc...xyz"
   export SEND_HOST="https://{slug}.sudinformatique.com"

3. 3. Lister les outils disponibles

   curl -H "Authorization: Bearer $SEND_TOKEN" \
        "$SEND_HOST/api/v1/tools" | jq '.data | length'
   
   # Réponse : 269

4. 4. Exécuter un outil (compress PDF)

   # 1. Dispatcher l'execution
   JOB=$(curl -sH "Authorization: Bearer $SEND_TOKEN" \
     -F "file=@/path/to/contract.pdf" \
     -F "preset=ebook" \
     "$SEND_HOST/api/v1/tools/pdf-compress/execute" | jq -r '.data.job_id')
   
   # 2. Polling jusqu'à completed
   while true; do
     STATUS=$(curl -sH "Authorization: Bearer $SEND_TOKEN" \
       "$SEND_HOST/api/v1/tools/jobs/$JOB" | jq -r '.data.status')
     [ "$STATUS" = "completed" ] && break
     [ "$STATUS" = "failed" ] && { echo "Failed"; exit 1; }
     sleep 2
   done
   
   # 3. Télécharger le résultat (URL signée 15 min)
   URL=$(curl -sH "Authorization: Bearer $SEND_TOKEN" \
     "$SEND_HOST/api/v1/tools/jobs/$JOB" | jq -r '.data.result_url')
   curl -L -o output.pdf "$URL"

Formats de réponse

Toutes les réponses suivent le même format JSON :

{
  "data": { ... },
  "meta": { ... },
  "links": { ... },
  "errors": []
}

Codes HTTP attendus

• 200 OK — succès synchrone
• 202 Accepted — job async dispatché, polling requis
• 400/422 — validation échouée (détails dans errors[])
• 401 — token manquant ou invalide
• 403 — token sans l'ability requise
• 404 — ressource introuvable ou cross-tenant
• 429 — rate limit dépassé (header Retry-After)
• 500 — erreur serveur (reported à Sentry)