API Sharecord

Crée des liens courts vers des fichiers qui s'effacent tout seuls, depuis tes scripts et tes outils.

Authentification

Crée un jeton personnel sur share.cordsuite.app/dashboard/tokens (Compte Cord requis). Il commence par shc_pat_ et s'envoie dans Authorization: Bearer ….

• Le jeton n'est affiché qu'une seule fois. Sharecord ne garde que son empreinte.
• Il agit comme toi : garde-le secret, et révoque-le s'il fuite (effet immédiat).
• Tu peux avoir 20 jetons actifs au plus, avec une durée de validité optionnelle.

Créer un lien

Un fichier part en morceaux d'au plus 4 000 000 octets, puis un seul appel crée le lien.

1. POST /api/v1/chunks?index=N pour chaque morceau (application/octet-stream, index à partir de 0). La réponse contient un token opaque, valable 24 h.
2. POST /api/v1/links avec les jetons de morceaux, dans l'ordre.

# 1. découper puis envoyer chaque morceau
split -b 4000000 rapport.pdf part_
i=0; tokens=""
for f in part_*; do
  t=$(curl -s -X POST "https://share.cordsuite.app/api/v1/chunks?index=$i" \
    -H "Authorization: Bearer $SHARECORD_TOKEN" \
    -H "Content-Type: application/octet-stream" \
    --data-binary @"$f" | jq -r .token)
  tokens="$tokens\"$t\","; i=$((i+1))
done

# 2. créer le lien
curl -X POST https://share.cordsuite.app/api/v1/links \
  -H "Authorization: Bearer $SHARECORD_TOKEN" -H "Content-Type: application/json" \
  -d "{\"expiration\":\"24h\",\"files\":[{\"name\":\"rapport.pdf\",\"mimeType\":\"application/pdf\",\"chunks\":[${tokens%,}]}]}"

Corps de POST /api/v1/links :

Réponse 201 :

{ "slug": "x7k2pAB", "url": "https://share.cordsuite.app/x7k2pAB", "expiresAt": "2026-10-26T13:00:00.000Z" }

Lire et révoquer

• GET /api/v1/links liste tes liens, du plus récent au plus ancien. Paramètres : limit (1 à 100, 20 par défaut) et cursor. La réponse contient data et nextCursor (null à la fin).
• GET /api/v1/links/:slug renvoie un lien : status (ok, expired, revoked ou exhausted), downloadCount, expiresAt, passwordProtected et la liste des fichiers. Les tailles sont des chaînes.
• DELETE /api/v1/links/:slug révoque le lien tout de suite. Les fichiers sont effacés ensuite par le nettoyage automatique. L'appel est idempotent.

Un lien qui n'est pas à toi répond 404, comme s'il n'existait pas.

Limites

• 2 Gio par fichier, 5 Gio par lien, 20 fichiers par lien.
• 600 requêtes par minute et par jeton, 120 liens créés par heure et par jeton. Les en-têtes RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset et Retry-After t'indiquent où tu en es.
• Les quotas de Drivecord s'appliquent aussi, car Sharecord y stocke les fichiers.

Erreurs

Toujours { "error": { "code", "message", "requestId" } }. Le code est stable :