¿Cómo valido y normalizo cadenas de cartas de póker con Pokerai API?
Envía una cadena compacta de cartas al punto de conexión público de normalización de PokerKit antes de usarla en un flujo de trabajo que reconoce cartas.
POST /v1/pokerkit/cards/normalize con la cadena cards obligatoria. El ejemplo público de CardsRequest es AsKsQs; consulta la Referencia actual antes de depender de cualquier campo de respuesta.Datos rápidos
| Dato | Contrato público |
|---|---|
| Operación | POST /v1/pokerkit/cards/normalize |
| Cuerpo obligatorio | cards, una cadena. |
| Ejemplo público | AsKsQs. |
| Notación de cartas | Cada carta tiene dos caracteres: rango AKQJT98765432 seguido del palo c, d, h o s; concatena las cartas sin separadores. |
| Forma de éxito | HTTP 200 está documentado, pero su esquema público de OpenAPI está abierto. Trata los campos JSON devueltos como datos de respuesta que debes inspeccionar, no como un contrato fijo a nivel de campo. |
Solicitud mínima respaldada por OpenAPI
curl -s https://pokerai.bet/v1/pokerkit/cards/normalize \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"cards":"AsKsQs"}'Esta solicitud usa el ejemplo público de CardsRequest. Una llamada correcta real devuelve JSON con HTTP 200; como la instantánea pública actual deja deliberadamente abierto ese esquema de respuesta, inspecciona el JSON realmente devuelto y no codifiques de forma rígida nombres de campos no documentados.
Entrada aceptada y límite de normalización
Usa cartas compactas de dos caracteres, como As, Kd y Th, concatenadas en una cadena como AsKsQs. Este endpoint valida y normaliza la entrada de cartas; no calcula equidad, evalúa una mano, recomienda una acción ni infiere una estrategia.
Errores comunes y privacidad
| Señal | Contrato público | Qué hacer |
|---|---|---|
HTTP 422 | HTTPValidationError | Comprueba que cards esté presente y sea una cadena JSON, y luego compara la notación enviada con la Referencia actual. |
| Autenticación | La operación enumera los encabezados de solicitud Authorization y X-API-Key. | Envía un encabezado de clave de API compatible; consulta Autenticación. |
| Privacidad | Las cartas pueden ser datos sensibles del juego o del usuario. | Envía solo lo necesario, mantén las claves de API fuera de los cuerpos de solicitud y los registros, y censura las cadenas de cartas del material de soporte cuando puedan identificar a un jugador o el historial de una mano. |
Usa la normalización en flujos de trabajo de entrenamiento, coaching, revisión de manos, estudio e investigación. No es asistencia en tiempo real con dinero real (RTA), no proporciona estrategia y no debe utilizarse para guiar acciones en mesas en vivo.
Documentación relacionada
- Centro de documentación — visión general de PokerKit y la API GTO.
- Guía de análisis de manos de póker — usa la entrada de cartas normalizada en flujos de análisis posteriores a la sesión.
- Referencia de la API — detalles actuales de solicitud y respuesta a nivel de operación.
- Instantánea de OpenAPI — el contrato público de
CardsRequesty la respuesta. - SDK de Python, SDK de TypeScript / JavaScript y servidor MCP — puntos de entrada oficiales de los paquetes.
Real-time assistance at real-money tables is prohibited.