API de broderie – digitizing.app

Obtenir une clé

L’accès API est un supplément aux formules Shop et Factory, et il est inclus dans Scale. Créez votre clé sur votre page de compte. Elle n’est affichée qu’une fois. Gardez-la sur votre serveur, jamais dans un navigateur ou une application.

Ouvrir votre compte

Créer un fichier

Envoyez le logo comme corps d’une requête POST. La réponse est le fichier de broderie lui-même.

curl -X POST "https://digitizing.app/api/v1/file?width_mm=80&format=dst" \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-binary @logo.png \
  -o logo.dst

Réglages

Réglage	Ce qu’il fait
`width_mm`	Largeur finie en millimètres. Obligatoire.
`format`	dst, pes, jef, exp, xxx ou vp3. Sans indication : dst.
`colors`	Nombre maximal de couleurs de fil, de 1 à 6. Sans indication : 6.
`body`	Le logo : PNG, SVG ou PDF, jusqu’à 4 Mo. Un PNG peut faire jusqu’à 6 mégapixels.

Réponses

Code	Ce qu’il signifie
`200`	Le fichier de broderie. L’en-tête X-Files-Left indique combien de fichiers il reste ce mois-ci.
`400`	Quelque chose ne va pas dans la requête. Le message dit quoi.
`401`	La clé manque ou n’est pas valide.
`402`	Pas de formule Shop ou Factory active, ou les fichiers du mois sont utilisés.
`403`	L’accès API n’est pas actif sur le compte.
`413`	Le fichier est trop volumineux.
`415`	Le fichier n’est pas un PNG, SVG ou PDF.
`429`	Trop d’appels. Attendez et réessayez.

Toute réponse qui n’est pas un fichier est du JSON avec un seul champ :

{ "error": "Give the finished width in millimetres: ?width_mm=80" }

Limites

Chaque fichier compte pour un fichier dans votre formule : une autre taille ou un autre format est un nouveau fichier. Exactement le même fichier dans les 15 minutes ne compte pas deux fois. Une clé peut faire 12 appels par minute et 1 000 appels par jour. Les appels envoyés au même moment attendent leur tour.

Votre logo

Le logo est gardé en mémoire pendant le calcul des points, et il disparaît dès que le fichier est envoyé. Rien n’est conservé.