Accede a información estructurada en formato JSON, a través de una API pública, diseñada para impulsar el desarrollo de aplicaciones digitales orientadas a la educación, la investigación y la atención relacionada con arañas, alacranes y serpientes de importancia médico-toxicológica en México.
Redtox API
Referencia técnica
Documentación de la API Redtox
Esta colección documenta los servicios web públicos expuestos por Redtox, una plataforma mexicana especializada en toxicología y especies venenosas. Los endpoints permiten consultar datos estructurados sobre especies, centros médicos y contenido académico relacionados con el envenenamiento y la toxicología en México.
Grupo 1
Buscador
Búsqueda de texto completo · 10 endpoints
Grupo 2
Datos
Datos estructurados filtrados · 3 endpoints
Formato
JSON
Todas las respuestas están en formato JSON.
Autenticación
Ninguna
Servicios web públicos.
URL base
https://redtox.org/servicio/
Estructura general
La colección está organizada en dos carpetas:
Buscador
10 endpoints
Endpoints de búsqueda de texto completo que replican la interfaz de búsqueda del sitio web de Redtox. Todas las solicitudes de este grupo aceptan un único parámetro de consulta —
keys
— que acepta cualquier palabra o combinación de palabras. Cada endpoint apunta a un tipo de contenido específico:
Hospitales
— Hospitales y unidades médicas
Universidades
— Universidades e instituciones académicas
Vinculaciones
— Organizaciones aliadas y brigadas
Artículos
— Artículos científicos e informativos
Videos
— Videos educativos
Casos Clínicos
— Casos clínicos
Antivenenos
— Documentos relacionados con antivenenos (principalmente en inglés)
Especies: Serpientes
— Especies de serpientes venenosas
Especies: Alacranes
— Especies de alacranes
Especies: Arañas
— Especies de arañas
Datos
3 endpoints
Endpoints de datos estructurados que devuelven registros detallados filtrados por parámetros específicos (p. ej., entidad, tipo de especie, distribución geográfica, tipo de contenido). Incluye:
Especies
— Perfiles taxonómicos y biológicos completos de especies venenosas
Centros
— Centros médicos filtrados por estado y tipo
Blog
— Contenido del blog filtrado por tipo de artículo y especie
URL base
Todos los endpoints comparten la URL base:
https://redtox.org/servicio/
Notas generales
Todas las respuestas están en formato JSON.
Cada registro incluye un campo
nid
(ID de nodo de Redtox) y un
node_url
que apunta al registro completo en el sitio web de Redtox.
Los endpoints de
Buscador
son ideales para la búsqueda por palabras clave; los endpoints de
Datos
son más adecuados para consultas filtradas y estructuradas.
Grupo 1
Buscador
Todas las consultas de la
API Redtox
que están agrupadas bajo el nombre de
Buscador
se comportan de manera similar a la interfaz de búsqueda en el sitio web de Redtox, y debido a eso, todas estas consultas funcionan con un único argumento, llamado
**keys**
. Usando este argumento en las consultas, se puede usar cualquier palabra o combinación de palabras para realizar búsquedas de información.
Aunque el argumento de la consulta es siempre el mismo y el único, la respuesta de cada tipo de consulta puede devolver distintos datos. dependiendo de la entidad que se esté consultando. Estas entidades de datos se enumeran a continuación:
Imagen de encabezado
Nombre científico
Nombre común
Especie común = "Alacranes"
URL en Redtox
NID (ID del registro en Redtox)
Ejemplo de uso
https://redtox.org/servicio/busqueda-especies-aranas?keys=violinista
Grupo 2
Datos
Esta parte de la
API Redtox
fue pensada originalmente para alimentar la app móvil Redtox con datos provenientes del sitio web. Lo que retorna cada consulta de esta parte de la API, es la estructura de datos correspondiente a cada una de las entidades que componen el sitio web de Redtox, como se enumeran a continuación:
Especies:
Animales ponzoñosos, que se dividen en: serpientes, alacranes y arañas.
Centros:
Instituciones de salud, universidades, organizaciones, etc., que cuentan con recursos para el tratamiento de piquetes y mordeduras de especies venenosas, o que se dedican al estudio e investigación de las mismas.
Blog:
Sección informativa compuesta por artículos, videos, casos clínicos, compendios y revistas digitales.
GET
Especies
/servicio/especies
URL
https://redtox.org/servicio/especies
Parámetros de consulta
Parámetro
Valor de ejemplo
Requerido
especie
Serpientes
Sí
distribucion
Ciudad de México
Sí
nid
275759
Opcional
Campos de cada registro · 34
Nombre científico
Reino
Phylum
Clase
Orden
Suborden
Familia
Género
Especie
Grupo
Subgrupo
Descubridores
Donde
especie
puede tener los valores: Arañas, Serpientes, o Alacranes; y
distribucion
corresponde a los nombres de los estados de la República Mexicana.
Se puede hacer la consulta con un solo argumento, por ejemplo: solo Puebla, retornará todas las epecies correspondientes a esa entidad, mientras que solo Alacranes, devolverá todas las especies de alacranes en cualquier entidad.
Opcionalmente, también puede usarse el argumento
nid
, que es numérico y corresponde al identificador interno de cada registro de datos dentro de Redtox.
Ejemplo de uso
https://redtox.org/servicio/especies?especie=Serpientes&distribucion=Ciudad de México
GET
Centros
/servicio/centros
Sin autenticación
URL
https://redtox.org/servicio/centros
Parámetros de consulta
Parámetro
Valor de ejemplo
Requerido
entidad
Zacatecas
Sí
tipo
Hospitales
Sí
nid
276004
Opcional
Campos de cada registro · 18
Tipo de centro
Entidad
Nombre
Ciudad
Dirección
Código Postal
Email
Teléfono
Misión
Objetivos
Material bibliográfico
Logotipo
Donde
entidad
es el nombre de cualquier entidad de la República Mexicana, y
tipo
puede tener los siguientes valores: Hospitales, Universidades, Vinculaciones, Centros toxicológicos.
Se puede hacer la consulta con un solo argumento, por ejemplo: solo Puebla, retornará todas las epecies correspondientes a esa entidad, mientras que solo Universidades, devolverá todas las instituciones de ese tipo en cualquier entidad.
Opcionalmente, también puede usarse el argumento
nid
, que es numérico y corresponde al identificador interno de cada registro de datos dentro de Redtox.
Ejemplo de uso
https://redtox.org/servicio/centros?entidad=Zacatecas&tipo=Hospitales
GET
Blog
/servicio/blog
Sin autenticación
URL
https://redtox.org/servicio/blog
Parámetros de consulta
Parámetro
Valor de ejemplo
Requerido
tipo
Artículo
Sí
especie
Arañas
Sí
nid
276910
Opcional
Campos de cada registro · 10
Título
Tipo
Especie común
Imagen de portada
Descripción
Video
Adjunto
Preview (solo para revistas digitales)
URL en Redtox
NID (ID del registro en Redtox)
Esta consulta no devuelve información detallada acerca del contenido de estos artículos, principalmente debido a que la mayoría de ellos se presenta en forma de videos o archivos PDF. La información obtenida en esta consulta puede servir para construir enlaces enriquecidos que conduzcan al contenido original alojado en Redtox.
Donde
tipo
puede tener los valores: Artículo, Video, Caso clínico, Antiveneno, Compendio, Revista; y
especie
puede ser: Arañas, Serpientes, o Alacranes.
Se puede hacer la consulta con un solo argumento, por ejemplo: solo Compendio, retornará todos los contenidos correspondientes a ese tipo, mientras que solo Alacranes, devolverá todos los contenidos de cualquier tipo relacionados en esa especie.
Opcionalmente, también puede usarse el argumento
nid
, que es numérico y corresponde al identificador interno de cada registro de datos dentro de Redtox.
Ejemplo de uso
https://redtox.org/servicio/blog?tipo=Artículo&especie=Arañas
Especificación OpenAPI
La especificación técnica completa de la API puede descargarse en formato JSON para utilizarse en herramientas compatibles con OpenAPI.
