Couleur de texte accessible
Ce suggesteur de couleur de texte accessible prend une couleur hexadécimale de fond, une hexadécimale de texte de départ et un rapport de contraste WCAG cible, puis renvoie une couleur de texte suggérée qui atteint ce rapport en ne déplaçant que la luminosité HSL.
Lancer gratuitement
La teinte et la saturation restent fixes, ainsi un bleu de marque reste bleu tout en s’assombrissant ou s’éclaircissant assez pour réussir AA ou AAA sur la surface donnée. Si la couleur de départ atteint déjà la cible, elle est renvoyée inchangée et marquée comme non ajustée. Si aucune luminosité de cette teinte n’atteint la cible — par exemple AAA 7:1 sur une carte gris moyen — le moteur renvoie tout de même le meilleur extrême, noir ou blanc, et place meets_target à false afin qu’un pipeline puisse échouer de façon fermée. Les concepteurs, les auteurs de jetons de design et les tâches de CI s’en servent lorsqu’un vérificateur de contraste ne suffit pas : ils ont besoin d’une hexadécimale de remplacement déterministe, pas seulement d’un drapeau de réussite ou d’échec. L’outil gratuit du navigateur et l’API partagent une seule fonction isomorphe, si bien qu’un atelier de palette et une porte automatisée ne divergent jamais. Il n’y a ni appels réseau, ni graines aléatoires, ni lecture d’horloge. Les appels API réussis sont facturés à $0.002 par élément ; une entrée invalide n’est pas débitée.
Comment l’utiliser
Saisissez vos données dans le formulaire ci-dessus. L’outil les vérifie avant le calcul et affiche le résultat sur la même page.
Vérifiez vos données
Suivez les libellés et les unités de chaque champ. Si une valeur manque ou sort de la plage autorisée, la page indique quoi corriger.
Relancez le calcul ou automatisez-le
Utilisez l’outil web pour les vérifications ponctuelles et l’API pour intégrer la même capacité à un flux automatisé.
Cas d’usage
Obtenez une réponse maintenant
Saisissez un jeu de valeurs et consultez le résultat sans créer de feuille de calcul ni de script.
Comparez des scénarios
Modifiez une valeur à la fois et relancez le calcul pour voir ce qui influence le résultat.
Automatisez les tâches répétées
Utilisez l’API lorsque le même calcul doit s’exécuter dans votre produit ou votre flux.
Questions fréquentes
Comment utiliser cette capacité ?
Remplissez les champs ci-dessus et lancez-la sur cette page. Le formulaire signale les données à corriger.
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/color/suggest-accessible-text \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"background":"#ffffff","text":"#888888"}'const res = await fetch("https://api.kit.forhosting.com/color/suggest-accessible-text", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"background": "#ffffff",
"text": "#888888"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/color/suggest-accessible-text",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"background": "#ffffff",
"text": "#888888"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/suggest-accessible-text", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"background":"#ffffff","text":"#888888"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"background":"#ffffff","text":"#888888"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/suggest-accessible-text", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"background": "#ffffff",
"text": "#888888"
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "color.suggest_accessible_text",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_color_chars | 32 |
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |