L’API crob.at pour tes projets
Récupère, génère et partage des équipes Pokémon.
Intègre l’API à ton application, à ton bot ou à un autre projet.
Crée ta première équipe
Envoie un export Pokémon Showdown.
Tu recevras un lien permanent à partager.
- Envoie ton équipeEnvoie un objet JSON avec le tableau
teamset place l’export danspaste. - Partage l’URL reçueGarde le jeton de gestion pour toi.
URL de la réponse
"url": "https://crob.at/abc123"Tu recevras une URL unique.L’exemple enregistre un seul Pokémon. Par défaut, l’équipe n’apparaît pas dans les listes publiques, mais toute personne ayant le lien peut la consulter.
/api/teamcurl --fail-with-body https://crob.at/api/team \
-H 'Content-Type: application/json' \
-d '{
"name": "My first team",
"teams": [{
"format": "gen9ou",
"paste": "Garchomp @ Choice Scarf\nAbility: Rough Skin\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head"
}]
}'const base = 'https://crob.at';
const paste = [
'Garchomp @ Choice Scarf',
'Ability: Rough Skin',
'EVs: 252 Atk / 4 SpD / 252 Spe',
'Jolly Nature',
'- Earthquake',
'- Dragon Claw',
'- Stone Edge',
'- Iron Head'
].join('\n');
const createdResponse = await fetch(`${base}/api/team`, {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'Example team',
public: false,
teams: [{format: 'gen9ou', paste}]
})
});
if (!createdResponse.ok) throw new Error(await createdResponse.text());
const created = await createdResponse.json();
console.log(created.url); // Share this URL, not management_token.
const teamResponse = await fetch(`${base}/api/team/${created.slug}`);
if (!teamResponse.ok) throw new Error(await teamResponse.text());
const team = await teamResponse.json();
console.log(team.teams[0].paste);Si la requête réussit, le serveur renvoie 201 Created.
Donne-lui le guide et le schéma. Les deux sont accessibles sans JavaScript.
Référence de l’API
Choisis un point de terminaison pour consulter les champs de requête, les exemples et les réponses.
GETRécupérer une équipe/api/team/:slug
Récupère une équipe à partir de son identifiant dans l’URL.
Exemple :
curl https://crob.at/api/team/abc123
const response = await fetch('https://crob.at/api/team/abc123');
if (!response.ok) throw new Error(await response.text());
const data = await response.json();
console.log(data);
import requests
response = requests.get('https://crob.at/api/team/abc123')
response.raise_for_status()
data = response.json()
print(data)
Réponse :
{
"slug": "abc123",
"name": "My Team",
"author": "username",
"description": "Short notes about how the team plays.",
"public": false,
"provenance": null,
"format_status": null,
"tournament": null,
"image": "https://crob.at/og/abc123.png",
"source_url": null,
"created_at": "2026-07-21 10:30:00",
"views": 12,
"is_multi": false,
"teams": [{
"format": "gen9ou",
"name": "My Team",
"paste": "Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head"
}]
}
GETRécupérer une équipe d’une collection/api/team/:slug/:teamSlug
Récupère une équipe dans un export qui en contient plusieurs. Utilise l’identifiant de l’équipe dans le lien de partage, par exemple /abc123/rain-offense.
Exemple :
curl https://crob.at/api/team/abc123/rain-offense
Réponse :
{
"paste_slug": "abc123",
"slug": "rain-offense",
"format": "gen9ou",
"name": "Rain Offense",
"paste": "Pelipper @ Damp Rock\nAbility: Drizzle\n- Hurricane\n- Surf\n- U-turn\n- Roost",
"url": "https://crob.at/abc123/rain-offense",
"image": "https://crob.at/og/abc123.png?team=rain-offense"
}
POSTPartager une équipe/api/team
Crée une équipe.
Requête :
{
"name": "My Team Name",
"author": "username",
"description": "Short notes about how the team plays.",
"public": false,
"teams": [{
"name": "My Team",
"format": "gen9ou",
"paste": "Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head"
}]
}
teams doit contenir au moins une entrée. Les noms, l’auteur et la description sont facultatifs et sont tronqués s’ils dépassent la longueur maximale. Si tu indiques un format, il doit être pris en charge par Pokémon Showdown.
Exemple :
curl -X POST https://crob.at/api/team \
-H "Content-Type: application/json" \
-d '{"name": "My Team", "description": "Fast offense with a Scarf cleaner.", "teams": [{"paste": "Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head"}]}'
const response = await fetch('https://crob.at/api/team', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
name: 'My Team',
description: 'Fast offense with a Scarf cleaner.',
teams: [{paste: 'Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head'}]
})
});
if (!response.ok) throw new Error(await response.text());
const {slug, url} = await response.json();
console.log(`Created: ${url}`);
import requests
response = requests.post('https://crob.at/api/team', json={
'name': 'My Team',
'description': 'Fast offense with a Scarf cleaner.',
'teams': [{'paste': 'Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head'}]
})
response.raise_for_status()
data = response.json()
print(f"Created: {data['url']}")
Réponse :
{
"slug": "abc123",
"url": "https://crob.at/abc123",
"image": "https://crob.at/og/abc123.png",
"management_token": "000000000000000000000000000000000000000000000000"
}
Renvoie 201 à la création de l’équipe. Le jeton de l’exemple est fictif. Garde la vraie valeur management_token en lieu sûr et partage uniquement l’URL.
GETGénérer une équipe/api/random-team/:format
Génère une équipe compétitive aléatoire pour un format Smogon. Renvoie l’export Showdown et le HTML de la carte affichée sur le site. L’équipe n’est pas enregistrée. Le générateur ne dispose pas de données pour tous les formats Showdown. Le format Random Battle de Showdown fonctionne séparément. Vérifie que l’équipe respecte les règles du serveur où tu veux jouer.
Paramètres de requête facultatifs : bias=staples|balanced|surprise, un nom de Pokémon pour include et un nom de Pokémon pour exclude . La pondération par défaut est balanced. Chaque nom doit comporter au plus 80 caractères et figurer dans la liste du générateur. Tu ne peux pas inclure et exclure le même Pokémon. Encode les noms pour l’URL.
Exemple :
curl https://crob.at/api/random-team/gen9ou
const response = await fetch('https://crob.at/api/random-team/gen9ou');
if (!response.ok) throw new Error(await response.text());
const data = await response.json();
console.log(data.teamText);
import requests
response = requests.get('https://crob.at/api/random-team/gen9ou')
response.raise_for_status()
data = response.json()
print(data['teamText'])
Réponse :
{
"teamText": "Garchomp @ Choice Scarf\nAbility: Rough Skin\nEVs: 252 Atk / 4 SpD / 252 Spe\nJolly Nature\n- Earthquake\n- Dragon Claw\n- Stone Edge\n- Iron Head\n\nCorviknight @ Leftovers\nAbility: Pressure\n- Roost\n- Defog\n- U-turn\n- Brave Bird\n\nRotom-Wash @ Leftovers\nAbility: Levitate\n- Hydro Pump\n- Volt Switch\n- Will-O-Wisp\n- Protect\n\nKingambit @ Black Glasses\nAbility: Supreme Overlord\n- Kowtow Cleave\n- Sucker Punch\n- Iron Head\n- Swords Dance\n\nClefable @ Leftovers\nAbility: Magic Guard\n- Moonblast\n- Moonlight\n- Stealth Rock\n- Thunder Wave\n\nDragapult @ Choice Specs\nAbility: Infiltrator\n- Shadow Ball\n- Draco Meteor\n- Flamethrower\n- U-turn",
"statsDate": "2026-03",
"cardsHtml": "<div class=\"pokemon-grid\">...</div>"
}
POSTEnregistrer une équipe générée/api/random-team/:format/save
Crée un lien permanent pour une équipe générée sans l’ajouter aux listes publiques. Envoie le champ teamText renvoyé par le générateur. Réutilise la même valeur de idempotencyKey si tu dois réessayer. Chaque client peut enregistrer jusqu’à 30 équipes par heure.
Exemple :
const generatedResponse = await fetch('https://crob.at/api/random-team/gen9ou');
if (!generatedResponse.ok) throw new Error(await generatedResponse.text());
const generated = await generatedResponse.json();
// Keep this body unchanged if the save needs a retry.
const saveBody = JSON.stringify({
teamText: generated.teamText,
idempotencyKey: crypto.randomUUID()
});
const savedResponse = await fetch('https://crob.at/api/random-team/gen9ou/save', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: saveBody
});
if (!savedResponse.ok) throw new Error(await savedResponse.text());
console.log((await savedResponse.json()).url);
Réponse :
{
"slug": "rAbCdEf12345",
"url": "https://crob.at/rAbCdEf12345",
"image": "https://crob.at/og/rAbCdEf12345.png"
}
Renvoie 201 pour un nouvel enregistrement, 200 pour une nouvelle tentative, 409 si la clé a déjà servi pour d’autres données, 400 si le format ou l’équipe est invalide, 429 si la limite de requêtes est atteinte, et 500 si l’équipe ne peut pas être enregistrée.
GETTrouver des exemples d’équipes/api/samples/:tier
Renvoie les exemples d’équipes de Smogon pour un format donné. Les résultats sont mis en cache pendant une heure.
Exemple :
curl https://crob.at/api/samples/gen9ou
const response = await fetch('https://crob.at/api/samples/gen9ou');
if (!response.ok) throw new Error(await response.text());
const teams = await response.json();
if (teams.length === 0) throw new Error('No sample teams available');
console.log(teams[0].url);
import requests
response = requests.get('https://crob.at/api/samples/gen9ou')
response.raise_for_status()
teams = response.json()
if not teams:
raise RuntimeError('No sample teams available')
print(teams[0]['url'])
Réponse :
[
{
"slug": "abc123",
"name": "Sun Offense",
"author": "Smogon",
"tier": "gen9ou",
"views": 142,
"created_at": "2026-01-15 10:00:00",
"url": "https://crob.at/abc123",
"image": "https://crob.at/og/abc123.png",
"source_url": "https://www.smogon.com/forums/..."
}
]
Renvoie 400 si :tier contient des caractères autres que des lettres ou des chiffres. Renvoie un tableau vide si le format ne propose aucun exemple d’équipe.
GETRécupérer les types des Pokémon/api/type-chart-data
Renvoie le nom de chaque Pokémon avec son type ou ses deux types. Les résultats sont mis en cache pendant 24 heures.
Exemple :
curl https://crob.at/api/type-chart-data
Réponse :
[
["Bulbasaur", ["Grass", "Poison"]],
["Charmander", ["Fire"]]
]
GETRécupérer l’utilisateur connecté/api/me
Renvoie l’utilisateur connecté à crob.at, s’il y en a un. Ce point de terminaison est destiné aux interfaces de même origine qui utilisent la session du navigateur.
Exemple :
curl https://crob.at/api/me \
-H "Cookie: session=your-session-cookie"
const response = await fetch('https://crob.at/api/me', {
credentials: 'include'
});
if (!response.ok) throw new Error(await response.text());
const data = await response.json();
console.log(data.user);
import requests
session = requests.Session()
session.cookies.set('session', 'your-session-cookie')
response = session.get('https://crob.at/api/me')
response.raise_for_status()
data = response.json()
print(data['user'])
Réponse :
{
"user": {
"username": "exampleuser",
"email": "[email protected]",
"ps_username": "ExampleUser",
"team_count": 7,
"favorite_count": 3
}
}
Renvoie {"user": null} si aucune session crob.at valide n’est active.
POSTEnvoyer un commentaire/api/feedback
Envoie un commentaire sur le produit avec des coordonnées facultatives. Chaque message peut contenir jusqu’à 2 000 caractères et chaque client peut en envoyer cinq par heure.
Exemple :
curl -X POST https://crob.at/api/feedback \
-H "Content-Type: application/json" \
-d '{"message":"The team viewer is useful.","contact":"[email protected]"}'
Réponse :
{"success": true}
Renvoie 400 si le message est vide ou invalide, 429 si la limite de requêtes est atteinte, et 500 si le commentaire ne peut pas être enregistré.
POSTConnexion à Showdown dans le navigateur/api/showdown/assertion
Fonction réservée aux navigateurs de même origine. Elle nécessite une session crob.at liée à Pokémon Showdown. Elle renvoie le statut HTTP 303 avec l’en-tête Location et un corps vide. Le navigateur doit terminer la vérification auprès de Showdown. La réponse ne contient pas d’assertion JSON.
Schéma de la requête : ShowdownAssertionRequest.
{
"challstr": "12345|abcdefghijklmnopqrstuvwxyz"
}
La chaîne du défi doit contenir de 1 à 2 048 caractères, sans saut de ligne. La réponse est 400 si la requête est invalide, 401 si une connexion à un compte Showdown lié est nécessaire, et 503 si OAuth de Showdown est indisponible. Les bots qui consultent uniquement les données d’équipe n’ont pas besoin de ce point de terminaison.
À savoir
Erreurs et nouvelles tentatives
Vérifie le statut HTTP avant de lire un champ de réponse en cas de succès. Les erreurs JSON contiennent error et peuvent contenir message et retryAfter. Par exemple : {"error":"Rate limit exceeded","retryAfter":60}.
400: corrige le JSON, le texte de l’équipe, le format ou la requête avant de réessayer.404: l’équipe ou les données du générateur sont indisponibles. Les listes d’exemples d’équipes peuvent renvoyer200avec[].409: la clé d’enregistrement d’une équipe générée a déjà servi pour d’autres données. Réutilise la même clé et le même corps lors d’une nouvelle tentative.429: attends le nombre de secondes indiqué parRetry-Afteravant de réessayer.500ou502: limite le nombre de nouvelles tentatives de lecture et augmente le délai entre elles. Si tu réessaies un enregistrement, garde le texte généré.
POST /api/team et POST /api/feedback n’acceptent pas de clés d’idempotence. Si tu ignores si le serveur a reçu une requête, la répéter peut créer un doublon. Chaque requête au générateur produit un nouveau résultat aléatoire.
Accès et prix
Toutes les opérations documentées sont gratuites. Les points de terminaison publics sont accessibles sans compte, clé d’API, moyen de paiement ni abonnement. Les fonctions facultatives liées au compte et à Pokémon Showdown utilisent la session crob.at du navigateur.
Limites de requêtes
POST /api/team: 500 équipes créées par heure et par clientPOST /api/random-team/:format/save: 30 équipes aléatoires enregistrées par heure et par clientPOST /api/feedback: 5 messages par heure et par client- Lorsque la limite est atteinte, la réponse utilise le statut HTTP
429et inclutRetry-After. Les points de terminaison d’écriture fournissent aussi les en-têtesX-RateLimit-*applicables.
Conditions d’utilisation de l’API
Utilise l’API conformément à la loi, sans perturber crob.at ni ses autres utilisateurs. Ne contourne pas les limites de requêtes, ne cherche pas à accéder à des données privées et n’envoie aucun contenu abusif ou portant atteinte aux droits de tiers. Ne prétends pas que crob.at, Pokémon Showdown, Nintendo, Game Freak ou The Pokémon Company soutiennent ton intégration. Le contenu d’une équipe publique relève de la responsabilité de la personne qui l’a soumise. L’API est fournie selon sa disponibilité, sans garantie de niveau de service, et peut évoluer. Les changements importants du contrat figureront dans le document OpenAPI et l’historique du dépôt. La politique de confidentialité explique comment crob.at traite les données de compte et de requête.
Sécurité
Les points de terminaison publics sont anonymes et accessibles sans clé. Les points de terminaison authentifiés utilisent une session crob.at sécurisée dans le navigateur et agissent uniquement sur le compte connecté. N’envoie jamais de cookie de session crob.at vers une autre origine et ne l’intègre pas au code client. Pour signaler une vulnérabilité de manière privée, écris à [email protected] en indiquant comment la reproduire. N’accède pas aux données de tiers et ne les modifie pas.
Conditions et compatibilité
- Les équipes doivent suivre le format d’export de Pokémon Showdown
POST /api/teamaccepte uniquement du JSON- Le texte des équipes peut contenir jusqu’à 500 000 caractères par requête
- Tu peux envoyer un export contenant une ou plusieurs équipes
/api/team,/api/team/:slug,/api/team/:slug/:teamSlug,/api/random-team/:format,/api/random-team/:format/save,/api/samples/:tier,/api/type-chart-dataet/api/feedbackacceptent les requêtes provenant d’autres origines/api/meet/api/showdown/assertionsont des points de terminaison qui utilisent la session du navigateur pour l’interface et l’authentification de crob.at
Schémas et guides pour les agents
Récupère /openapi.json avant de générer un client. Le champ jsonSchemaDialect indique https://json-schema.org/draft/2020-12/schema. Résous les références locales $ref dans le document lui-même. Le fichier complet est un document OpenAPI. Les schémas de requête et de réponse se trouvent dans components.schemas.
CreateTeamRequest→CreatedTeam: créer une collection d’équipes.TeametTeamInPaste: récupérer une collection ou une équipe qui en fait partie.GeneratedTeam: export généré, mois des statistiques d’utilisation et HTML d’affichage.SaveGeneratedTeamRequest→CreatedTeam: enregistrer un export généré.Error: texte de l’erreur avec les champs facultatifsmessageetretryAfter.
Le schéma indique les champs obligatoires. Certains champs de réponse peuvent valoir null. Accepte les champs supplémentaires dans les réponses. Les schémas JSON décrivent la structure des données. Le serveur vérifie aussi que le texte peut être lu comme une équipe Pokémon, que les formats sont pris en charge et que le texte respecte la longueur totale maximale.
Autres fichiers de documentation : conditions d’accès et de compte, APIs.jsonet catalogue d’API.