API di ricamo – digitizing.app

Ottieni una chiave

L’accesso API è un’aggiunta ai piani Shop e Factory, ed è incluso in Scale. Crea la chiave nella pagina del tuo account. Viene mostrata una sola volta. Tienila sul tuo server, mai in un browser o in un’app.

Apri il tuo account

Crea un file

Invia il logo come corpo di una richiesta POST. La risposta è il file di ricamo stesso.

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

Impostazioni

Impostazione	Cosa fa
`width_mm`	Larghezza finita in millimetri. Obbligatoria.
`format`	dst, pes, jef, exp, xxx o vp3. Senza indicazione: dst.
`colors`	Numero massimo di colori di filo, da 1 a 6. Senza indicazione: 6.
`body`	Il logo: PNG, SVG o PDF, fino a 4 MB. Un PNG può arrivare a 6 megapixel.

Risposte

Codice	Cosa significa
`200`	Il file di ricamo. L’intestazione X-Files-Left dice quanti file restano questo mese.
`400`	Qualcosa nella richiesta non va. Il messaggio dice cosa.
`401`	La chiave manca o non è valida.
`402`	Nessun piano Shop o Factory attivo, oppure i file del mese sono finiti.
`403`	L’accesso API non è attivo sull’account.
`413`	Il file è troppo grande.
`415`	Il file non è un PNG, SVG o PDF.
`429`	Troppe chiamate. Aspetta e riprova.

Ogni risposta che non è un file è JSON con un solo campo:

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

Limiti

Ogni file conta come un file nel tuo piano: un’altra misura o un altro formato è un nuovo file. Esattamente lo stesso file entro 15 minuti non conta due volte. Una chiave può fare 12 chiamate al minuto e 1.000 chiamate al giorno. Le chiamate inviate nello stesso momento aspettano il loro turno.

Il tuo logo

Il logo resta in memoria mentre vengono calcolati i punti, e sparisce quando il file è inviato. Non viene conservato nulla.