Presentamos la API de TecnoFans Teams

En TecnoFans, nuestro objetivo es ayudar a los equipos a mantenerse al día con las tendencias importantes de la industria y, al mismo tiempo, obtener una comprensión más profunda de sus competidores y clientes.

Ahora puede acceder al contenido de los feeds y tableros de TecnoFans AI a través de una API, para automatizar los flujos de trabajo y difundir información de manera más eficiente.

En este documento, le mostraremos cómo:

• Acceda a la lista de artículos asociados con un AI Feed o un tablero
• Descargar el contenido de un artículo
• Busque artículos específicos en sus feeds y tableros de IA
• Guarde un artículo en un tablero o agréguele una nota.

La API TecnoFans utiliza un formato HTTP REST + JSON y es fácilmente accesible a través de cualquier lenguaje de programación. Está protegido por un mecanismo de seguridad OAuth2. Necesitarás un ficha de desarrollador asociado con su cuenta de TecnoFans Teams para acceder al contenido de los equipos. (Leer más: cómo obtener un token de desarrollador)

Listado de artículos en un feed o tablero

Todas las listas de artículos (a nivel de fuente individual, feed o tablero) se exponen como un flujo de elementos (Artículo es un término RSS para un artículo).

Para obtener la lista de artículos asociados con una fuente de equipo o un tablero de equipo, debe identificar la identificación única de esa fuente de IA o ese tablero. Cuando abres un AI Feed o un tablero en la aplicación web TecnoFans, la identificación aparece en la barra de URL del navegador.

Para AI Feeds, la URL en el navegador se verá así: https://feedly.com/i/collection/content/empresa/acme/categoría/45c32255-1234-4c06-2321-1991de3c2bb2

La identificación es la parte de la URL que comienza con empresa:

empresa/acme/categoría/45c32255-1234-4c06-2321-1991de3c2bb2

Para Boards, la URL en el navegador se verá así:

https://feedly.com/i/board/content/empresa/acme/tag/45c32255-1234-4c06-2321-1991de3c2ddd

Nuevamente, la identificación que le interesa es la parte que comienza con empresa:

empresa/acme/tag/45c32255-1234-4c06-2321-1991de3c2ddd

Una vez que tenga la identificación del feed o tablero AI al que desea acceder, puede usar /v3/punto final de flujos para recuperar la lista de artículos asociados con el feed o el tablero.

OBTENER /v3/streams/:replace_with_id/contents

Dado que el contenido de los feeds y tableros de IA es privado para un equipo, esta solicitud debe autenticarse. Necesitará obtener un ficha de desarrollador y pase ese token en el encabezado o URL de la solicitud.

Puedes usar el contar, solo no leídos, clasificados y más nuevos que parámetros de entrada para adaptar esta solicitud a sus necesidades específicas.

Puede solicitar hasta 100 artículos a la vez utilizando el parámetro de recuento. Si necesita más artículos, deberá aprender a utilizar el parámetro de continuación para paginar artículos en lotes de 100.

Anatomía de un artículo (también conocido como artículo)

El resultado de un llamada v3/transmisión es una lista de elementos que representan los artículos que pertenecen al feed o tablero al que intenta acceder.

{
“alterno”: [
{
“type”: “text/html”,
“href”: “http://www.theverge.com/”
}
],
“dirección”: “litro”,
“actualizado”: 1367539068016,
“elementos”: [
{
“engagement”: 15,
“author”: “Nathan Ingraham”,
“alternate”: [
{
“type”: “text/html”,
“href”: “http://www.theverge.com/2013/4/17/4236096/nbc-heroes-may-get-a-second-lease-on-life-on-xbox-live”
}
],
“etiquetas”: [
{
“label”: “inspiration”,
“id”: “user/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/inspiration”
}
],
“origen”: {
“streamId”: “feed/http://www.theverge.com/rss/full.xml”,
“htmlUrl”: “http://www.theverge.com/”,
“title”: “The Verge – Todas las publicaciones”
},
“no leído”: verdadero,
“actualizado”: 1367539068016,
“publicado”: 1367539068016,
“gateado”: 1367539068016,
“title”: “El vilipendiado drama de ciencia ficción de NBC ‘Heroes’ puede tener una segunda vida como exclusivo de Xbox Live”,
“categorías”: [
{
“label”: “tech”,
“id”: “enterprise/c805fcbf-3acf-4302-a97e-d82f9d7c897f/category/tech”
}
],
“contenido”: {
“dirección”: “litro”,
“contenido”: “…”
},
“id”: “A=_13fb9d6f274:2ac9c5:f5718180”
},
{
“compromiso”: 39,
“autor”: “TC Sottek”,
“alterno”: [
{
“type”: “text/html”,
“href”: “http://www.theverge.com/2013/4/17/4236136/senate-rejects-gun-control-amendment”
}
],
“etiquetas”: [
{
“label”: “inspiration”,
“id”: “enterprise/c805fcbf-3acf-4302-a97e-d82f9d7c897f/tag/competition”
}
],
“origen”: {
“streamId”: “feed/http://www.theverge.com/rss/full.xml”,
“htmlUrl”: “http://www.theverge.com/”,
“title”: “The Verge – Todas las publicaciones”
},
“no leído”: verdadero,
“actualizado”: 1367539068016,
“publicado”: 1367539068016,
“gateado”: 1367539068016,
“title”: “El Senado rechaza medida bipartidista de control de armas para verificación de antecedentes”,
“categorías”: [
{
“label”: “tech”,
“id”: “enterprise/c805fcbf-3acf-4302-a97e-d82f9d7c897f/category/tech”
}
],
“contenido”: {
“dirección”: “litro”,
“contenido”: “…contenido html…”
},
“id”: “gRtwnDeqCDpZ3fb9d6f274:2ac9c5:f5718182”
}
],
“title”: “The Verge – Todas las publicaciones”,
“id”: “feed/http => //www.theverge.com/rss/full.xml”,
“continuación”: “gRtwnDeqbXn2XpDA=_13fb9d6f274:2ac9c5:f5718180”
}

Un elemento es una estructura JSON rica que representa todas las diferentes facetas de un artículo.

El contenido La propiedad le permitirá descargar el contenido del artículo.

El categorias array le permitirá saber a qué feeds pertenece este artículo.

El etiquetas array le permitirá saber en qué tableros se ha guardado este artículo.

Si el artículo incluye notas o aspectos destacados, los encontrará en el anotaciones formación.

El elemento también incluye metadatos sobre el artículo: fecha de publicación/actualización, origen, autor, participación, etc. Cualquier información que vea en la interfaz de usuario de TecnoFans con respecto a los artículos también se incluye en la representación del elemento de la API.

Buscar un artículo

La API también le permite buscar dentro de la cuenta del TecnoFans Team para encontrar artículos específicos por palabra clave, tipo de contenido, etc.

OBTENER /v3/search/contents?streamId=:replace_with_id&query=:searchTerm

El punto final v3/búsqueda/contenidos le permite buscar un término en un feed, tablero, fuente de IA específico o en todo su TecnoFans. Usted controla el alcance de la búsqueda a través del parámetro streamId. Esta es la misma identificación que usamos anteriormente para enumerar el contenido de un feed o tablero específico.

Hay 2 identificadores globales que serían útiles si desea buscar en todos sus feeds o en todos sus tableros:

empresa/acme/categoría/global.all es la identificación de transmisión global que le permite buscar en todas las fuentes de su equipo (reemplace cumbre con su identificación de equipo).

empresa/acme/tag/global.all es la identificación de transmisión global que le permite buscar en todos los tableros de su equipo (reemplace cumbre con su identificación de equipo).

Esta solicitud de búsqueda se puede personalizar utilizando consulta, recuento, más reciente que, campos, incrustados, participación y configuración regional.

Devolverá una lista de elementos, cada elemento representa un artículo que coincide con la solicitud de búsqueda.

Consejo profesional: También puede establecer el alcance de la búsqueda para que sea una fuente individual. Cada fuente tiene una identificación que combina alimentar/ y la URL del RSS: feed/http://daringfireball.net/index.xml

feed/http://daringfireball.net/index.xml

También puede establecer el alcance de la búsqueda para que sea una fuente individual. Cada fuente tiene una identificación que combina

alimentar/

y la URL del RSS:

feed/http://daringfireball.net/index.xml

¿Buscando fuentes?

TecnoFans también ofrece una API que te permite buscar nuevas fuentes

OBTENER /v3/búsqueda/feeds

El v3/búsqueda/punto final de feeds te permite buscar las fuentes individuales que puedes seguir en tu TecnoFans. Puede pasar el título o la URL de un sitio que desea seguir o un #tema (con un prefijo hash) y TecnoFans le devolverá una lista de recomendaciones.

{
“sitio web”: “http://daringfireball.net/”,
“velocidad”: 47,8,
“title”: “Bola de fuego atrevida”,
“feedId”: “feed/http://daringfireball.net/index.xml”,
“suscriptores”: 359471
},

El resultado enumera información sobre cada recomendación: la URL del sitio web, la velocidad (número de artículos publicados por semana), el título, la identificación de la fuente y el número de suscriptores.

Guardar un artículo en un tablero

Cada artículo tiene una identificación única. Esta identificación se incluye en el elemento que representa ese artículo. Si desea guardar un artículo en un tablero, deberá determinar la identificación del artículo y la identificación del tablero y usar el v3/punto de entrada de etiquetas:

PUT /v3/tags/:replace_with_id_of_board

Pasando como entrada en el cuerpo, el id del artículo.

{
“entryId”: “gRtwnDeqCDpZ42bXE9Sp7dNhm4R6NsipqFVbXn2XpDA=_13fb9d6f274:2ac9c5:f5718180”
}

Consejo profesional:v3/tags también admite un operación BORRAR que le permite desguardar un artículo de un tablero.