Índice:
- Introducción
- Documentación de Métricas Propietarias
- ¿Cómo se presenta la documentación y cómo se presentan los datos al programador?
Introducción
La documentación de la API es un contenido técnico con información sobre cómo utilizar y llevar a cabo una integración efectiva con otra API, lo que permite una mayor autonomía en la adopción de la funcionalidad.
Servicios Personalizados: ¿Necesitas ayuda en la importación de datos estructurados? ¡Podemos ayudarte! Nuestro equipo de expertos está listo para atenderte. Contacta a tu Gerente de Cuentas de STILINGUE para acceder a este y otros servicios.
Para obtener más información sobre la API de STILINGUE (qué es, cómo funciona y cómo adquirirla), consulta nuestra guía.
Nuestra documentación se actualiza constantemente y actualmente abarca los siguientes puntos:
- Parámetros obligatorios y opcionales de entrada;
- Limitaciones;
- Requisitos de autenticación;
- Métodos aceptados;
- Valor recibido.
La API STILINGUE se ofrece para los productos Listening, Métricas Propietarias y STILINGUE Smart Care. Consulte a continuación los datos extraídos, las limitaciones y sus posibles soluciones por producto:
Documentación de Métricas Propietarias:
Al igual que en Listening, aquí también es posible obtener datos de casi todas las áreas, según el menú lateral de cada red social. En Facebook, por ejemplo, existen las opciones: Visión General, Usuarios más comprometidos, Facebook Insights, Análisis de publicaciones, Análisis de comentarios y Comparación de Fanpages.
Consulte a continuación las limitaciones de la documentación:
| Área | Limitaciones | Soluciones de Contorno |
| 1) Facebook | Publicaciones activadas | |
| Publicaciones | Las publicaciones, Todos los comentarios, Bandeja de entrada y Publicaciones de Visitantes pueden encontrarse en la API de Listening (a través del filtro de Conversaciones, utilizando el parámetro fanpages) | |
| Todos los comentarios | ||
| Bandeja de entrada | ||
| Evaluaciones | ||
| Publicaciones de visitantes | ||
| 2) Twitter | Publicaciones VS. Interacciones | |
| Publicaciones | Las publicaciones, Todos los comentarios, Mensajes Directos y Menciones pueden encontrarse en la API de Listening (a través del filtro de Conversaciones, utilizando el parámetro fanpages) | |
| Todos los comentarios | ||
| Mensajes directos | ||
| Menciones | ||
| Contenido de URL: "post_url", "user_image_url", "user_url", "post_user_image_url | Utilizando el ID del tweet, es posible recuperar la información a través de la API de Twitter: https://developer.twitter.com/en/docs/tweets/post-and-engage/api-reference/get-statuses-show-id.html | |
| 3) Youtube | Publicaciones | Estos datos se pueden encontrar en la API de Listening (a través del filtro de Conversaciones) |
| Todos los comentarios | ||
| 4) Instagram | Publicaciones | Estos datos se pueden encontrar en la API de Listening (a través del filtro de Conversaciones) |
| Todos los comentarios |
Accede a la documentación completa de Métricas Proprietárias a través del link:
Dentro de cada documento de ayuda al programador, explicamos la raíz, el endpoint (URL donde se puede acceder al servicio) para el inicio del "ensamblaje de piezas de lego", un diccionario que ayuda en el significado de cada código, las limitaciones y protocolos de nuestra API y las solicitudes necesarias.
¿Cómo se presenta la documentación y cómo se presentan los datos al programador?
Aquí tenemos la imagen del War Room para identificar la ubicación exacta de la información deseada, un ejemplo de la solicitud (texto curl), los endpoints con sus campos, tipos, retornos obtenidos, descripciones y obligatoriedades, las reglas de negocio, el cuerpo de la respuesta y la respuesta en formato JSON.
¿Cuáles son las restricciones de la API STILINGUE? En las solicitudes enviadas, solo es posible realizar un pedido a la vez; las solicitudes pueden tardar hasta 60 segundos en enviarse—por ejemplo, cuando el intervalo de fechas es muy largo o cuando se solicitan muchas publicaciones. Si este tiempo se excede, se debe intentar nuevamente. Cuando sea necesaria una reconexión, aparecerá la siguiente notificación:
Para obtener más información, visite la discusión sobre el tema en nuestra comunidad o vea los videos en nuestro canal. 😃