ForHosting KIT · Outils pour développeurs

Encodeur Ecoji

Enveloppez un message court dans des emojis qui passent dans n'importe quelle messagerie : Hello, Ecoji! fait 13 octets et devient 12 emojis, et en les recollant vous retrouvez le texte exact, accents compris. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Texte: Hello, Ecoji!

Vous obtenez

Résultat: 🏯🔩🚗🌷🍸📖🐩🤜👺🕺🌆☕
Mode de calcul: Encode
Version: v2
Nombre d'emojis: 12

Ecoji est un codage de transfert en base 1024 qui projette des données binaires sur un ensemble d'emojis Unicode sélectionnés, afin que messages courts, jetons et sommes de contrôle circulent dans les discussions, tickets et pages d'état qui préfèrent des caractères faciles à coller au Base64 brut. Chaque emoji porte dix bits, donc cinq octets d'entrée deviennent quatre symboles visibles — moins de caractères que le Base64 pour la même charge, même si chaque glyphe est multi-octets en interne. Cette capacité encode le texte UTF-8 brut en Ecoji (version 2 par défaut avec rembourrage réduit) et décode Ecoji version 1 ou 2 vers le texte, en rejetant les séquences inconnues ou de versions mélangées avec une erreur d'entrée invalide explicite. Utilisez-la lorsque vous avez besoin d'une enveloppe visible et sûre pour coller de courtes chaînes sans installer un CLI Ecoji local.

Encoder du texte en emojis Ecoji V2 (ou V1)

Le moteur sérialise la chaîne en octets UTF-8, regroupe chaque cinq octets en un mot de quarante bits et mappe quatre ordinaux successifs de dix bits dans l'alphabet Ecoji de mille vingt-quatre emojis. Lorsque le bloc final est plus court que cinq octets, Ecoji insère des symboles de rembourrage pour que le décodeur retrouve la longueur exacte : la version 2 coupe le rembourrage redondant pour les queues d'un ou deux octets, tandis que la version 1 complète toujours chaque groupe final à quatre emojis.

Fixez version à 2 (la valeur par défaut) pour des collages modernes, ou version à 1 pour interopérer avec des outils anciens uniquement V1. Les chaînes vides sont valides et s'encodent en un résultat vide avec zéro octet. Texte multilingue, ponctuation et emojis ordinaires dans la source font l'aller-retour car le chemin est UTF-8 complet, pas un raccourci Latin-1.

Des entrées identiques produisent toujours des sorties identiques car l'algorithme est de l'arithmétique pure sans réseau, sans sel aléatoire et sans horloge murale.

Décoder des emojis Ecoji et signaler une entrée invalide

Fixez mode à decode et placez une chaîne d'emojis Ecoji dans text. Le décodeur accepte Ecoji V1 et V2 : les symboles propres à une version fixent la version attendue pour le reste de la charge, et un symbole ultérieur propre à l'autre est rejeté comme corruption de versions mélangées. Le rembourrage de remplissage (l'emoji café) et les glyphes spéciaux de rembourrage du dernier octet reconstruisent les blocs finaux courts afin qu'un, deux, trois ou quatre octets résiduels se décodent sans approximation.

Entrée Ecoji vide, rembourrage en première position, groupes tronqués sous les règles V1 et emojis inconnus sont des erreurs dures.

Cas d’usage

Jetons courts sûrs pour le chat

Encodez fragments de configuration et identifiants de ticket en Ecoji pour qu'ils survivent aux applications de discussion et pages d'état qui cassent la ponctuation Base64, puis décodez sur le service récepteur avec le même champ mode.

Questions fréquentes

Comment encoder du texte en emojis Ecoji ?

Le champ result contient la chaîne d'emojis Ecoji ; version vaut v2 par défaut.

Comment décoder Ecoji vers du texte ?

Envoyez mode decode et placez la chaîne d'emojis Ecoji dans text.

Quelle est la différence entre Ecoji V1 et V2 ?

Ils utilisent des alphabets de 1024 emojis distincts (les symboles partagés gardent le même ordinal). V2 réduit le rembourrage sur les queues courtes ; V1 complète toujours chaque groupe final à quatre emojis. Le décodage accepte les deux.

Pourquoi une chaîne Ecoji se termine-t-elle souvent par une tasse de café ?

L'emoji café sert de remplissage. Quand le dernier bloc du texte fait moins de cinq octets, les symboles de remplissage indiquent au décodeur la longueur exacte de l'original, pour le reconstruire sans caractère en trop ni en moins.

Ecoji est-il plus court que Base64 ?

En caractères visibles, oui : chaque emoji porte dix bits, donc cinq octets deviennent quatre symboles. En octets, en revanche, chaque emoji en occupe plusieurs, ce qui rend le résultat plus lourd à stocker.

Outils associés

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

POSThttps://api.kit.forhosting.com/enc/ecoji

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/enc/ecoji \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello, Ecoji!"}'

const res = await fetch("https://api.kit.forhosting.com/enc/ecoji", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "Hello, Ecoji!"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/enc/ecoji",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "Hello, Ecoji!"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/enc/ecoji", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"Hello, Ecoji!"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"Hello, Ecoji!"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/enc/ecoji", 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

{
  "text": "Hello, Ecoji!"
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "enc.ecoji",
  "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

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

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.

Notes techniques

Encoder du texte en emojis Ecoji V2 (ou V1)

Envoyez un corps JSON avec le champ chaîne obligatoire text défini sur le message à transporter, et laissez mode à sa valeur par défaut encode ou fixez mode à encode explicitement. Les alias optionnels input, value et s sont acceptés pour le champ text, et direction, op ou action pour mode, afin que les clients générés avec d'anciens noms de formulaire fonctionnent encore. La réponse inclut toujours result avec la chaîne Ecoji, mode égal à encode, version en v1 ou v2, emoji_count comme nombre de points de code emoji produits, et bytes comme longueur UTF-8 avant encodage pour que les tests puissent affirmer la taille.

Décoder des emojis Ecoji et signaler une entrée invalide

Les sauts de ligne et retours chariot sont ignorés pour que les collages multilignes fonctionnent encore, mais tout point de code hors de l'alphabet de données et du jeu de rembourrage Ecoji provoque un échec immédiat invalid_input avec un message qui nomme le caractère fautif. Une fois les octets récupérés, ils sont interprétés en UTF-8 avec un décodeur fatal : les séquences illégales lèvent invalid_input au lieu d'insérer des caractères de remplacement qui corrompraient les affichages en aval. Un décodage réussi renvoie result comme chaîne récupérée, mode decode, version v1 ou v2, emoji_count pour les symboles hors saut de ligne de l'entrée, et bytes comme longueur UTF-8 décodée. Les échecs de validation ne sont pas facturés sur l'API prépayée, donc sonder un collage suspect est peu coûteux pour les opérateurs et sûr pour les utilisateurs finaux qui n'ont besoin que d'un diagnostic clair.

Usage API, tarification, flux et limites pratiques

Appelez l'encodeur Ecoji gratuit dans le navigateur pour des démonstrations en classe, des playbooks de support et des conversions ponctuelles sans installer l'outil de référence en Go ni des paquets par langage. Un flux typique encode un fragment de configuration ou un identifiant de ticket pour un canal de discussion qui altère la ponctuation Base64, puis décode sur le service récepteur avec mode decode en affirmant que bytes correspond à la longueur d'origine. Préférez Ecoji lorsque l'intention de recherche est un codage de transfert par emojis ou encoder/décoder Ecoji ; préférez Base64 ou Base58 lorsque le canal est ASCII pur et les polices d'emojis peu fiables. Utilisez l'API KIT prépayée lorsqu'un backend, une fonction serverless ou un SDK a besoin de la même étape d'encodage ou de décodage sous solde à $0.002 par élément réussi ; une validation échouée ne consomme jamais le solde après le rejet du moteur. Les auteurs de SDK peuvent mapper le champ result directement sur un bouton copier, tandis que les libellés mode, version et emoji_count rendent captures et exemples OpenAPI explicites pour les lecteurs nouveaux aux codages emoji base-1024.

Cas d'intégration

Documentation et fixtures CI

Épinglez des fixtures d'encodage et de décodage pour Ecoji V1 et V2 afin que les exemples de documentation et les tests d'intégration continue échouent vite si l'alphabet ou le rembourrage dérivent.

Support et formation

Agents et apprenants convertissent le texte en Ecoji et retour dans le widget gratuit du navigateur, avec des erreurs invalid_input claires lorsqu'un collage contient des emojis inconnus ou de versions mélangées.

Questions techniques

L'encodeur d'emojis Ecoji est-il gratuit ?

L'outil navigateur s'exécute gratuitement sur votre appareil. Les appels API utilisent le solde KIT prépayé à $0.002 par élément réussi ; les échecs de validation ne sont pas facturés.

Que se passe-t-il si la chaîne d'emojis est invalide ?

Le décodage échoue avec invalid_input lorsqu'un caractère n'est pas dans l'alphabet Ecoji, le rembourrage est illégal, les versions sont mélangées, la charge est vide ou les octets récupérés ne sont pas de l'UTF-8 valide. La requête n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Encoder du texte en emojis Ecoji V2 (ou V1)

Décoder des emojis Ecoji et signaler une entrée invalide

Cas d’usage

Jetons courts sûrs pour le chat

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Encoder du texte en emojis Ecoji V2 (ou V1)

Décoder des emojis Ecoji et signaler une entrée invalide

Usage API, tarification, flux et limites pratiques

Cas d'intégration

Documentation et fixtures CI

Support et formation

Questions techniques

merci