Generatore campione colore SVG

La convalida fallita è segnalata come invalid_input e non viene fatturata, il che mantiene sicuri i generatori automatici di legende quando un campo CMS conserva ancora un nome colore in bozza invece di un codice hex.

Che cos'è un campione colore SVG e quando serve

Questa capacità standardizza quel chip: Lei invia una stringa colore e riceve un SVG fisso con width, height, viewBox, role e un aria-label accessibile, più l'hex a sei cifre espanso e i canali RGB per tabelle accanto al grafico.

Contratto di input, regole di convalida e campi di risposta

La forma abbreviata a tre cifre come #abc si espande in #aabbcc e viene portata in minuscolo per un contratto stabile. Larghezza e altezza opzionali sono interi da uno a cinquecentododici inclusi; se li omette ottiene il chip predefinito ventiquattro per ventiquattro usato nelle legende dense. Il rx opzionale imposta un raggio d'angolo; deve essere un numero finito maggiore o uguale a zero e non superiore alla metà del lato minore, con predefinito zero per angoli vivi. L'ordine degli attributi è fisso, così il confronto byte per byte nei test resta stabile tra motori JavaScript. Invii con POST un oggetto JSON con un campo color obbligatorio: una stringa hex di tre o sei cifre esadecimali, con o senza cancelletto iniziale. Lunghezze non valide, caratteri non hex, prefissi 0x, numeri nudi e stringhe vuote falliscono con invalid_input indicando il problema. In caso di successo il corpo ripete il colore normalizzato come color e hex, l'hex_raw originale trimmato, i canali interi r, g e b, width, height e rx risolti, una stringa view_box, un flag shorthand, un breve messaggio e la stringa SVG due volte come svg e markup affinché i client che si aspettano l'uno o l'altro nome possano legare senza mappare. La radice SVG include sempre il namespace SVG, attributi width e height coincidenti, un viewBox di zero zero width height, role uguale a img e un aria-label che include l'hex normalizzato per i lettori di schermo.

Dove un'API di campione colore SVG conviene

I bot di QA design possono rigenerare ogni campione da un file di token in CI e far fallire la build quando il markup diverge, intercettando maiuscole accidentali o hash mancanti prima delle note di rilascio. I generatori di documentazione che trasformano token di design in pagine leggibili possono chiamare questo endpoint una volta per token e iniettare il markup restituito accanto al nome del token, al valore hex e alla nota d'uso senza inventare template SVG per framework. I costruttori di legende per grafici e mappe necessitano di chip della stessa dimensione con riempimenti diversi; fissare width e height e variare solo il colore mantiene l'allineamento prevedibile in tabelle e righe flex. Poiché l'implementazione è parse puro di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello né rete in uscita, e la convalida fallita non consuma saldo.