documentacion twitter

99
Directrices y Condiciones Desarrollador Directrices, normas de circulación, y Términos de Servicio Mostrar Directrices Geo Directrices para desarrolladores Desarrollador Reglas del Camino Twitter sostiene una plataforma abierta que apoya a los millones de personas en todo el mundo que está compartir y descubrir lo que está sucediendo ahora. Queremos potenciar a nuestros socios del ecosistema para establecer negocios alrededor de la valiosa información que fluye a través de Twitter. Al mismo tiempo, nuestro objetivo es lograr un equilibrio entre el fomento de desarrollo interesante y proteger tanto a Twitter y los derechos de los usuarios. Así, hemos llegado con un conjunto de reglas para desarrolladores de la carretera ("Reglas") que se aplican a todos los desarrolladores y empresas de construcción productos y servicios que interactúan con Twitter. Si usted es un usuario de los servicios de Twitter, pero no un desarrollador, estas normas solo se verá lo que nuestros socios están autorizados a ver con el contenido y la información que comparte con Twitter. El Reglamento deberá evolucionar junto con nuestros ecosistemas como los desarrolladores de seguir innovando y buscar formas nuevas y creativas para utilizar la API de Twitter, así que por favor revise periódicamente para ver la versión más actual. Si usted está haciendo algo prohibido por las Normas, hablar con nosotros acerca de si deberíamos hacer un cambio o que se haga una excepción. I. acceso a la API 1. Todo uso de la API de Twitter y el contenido, documentación, código y otros materiales relacionados a disposición de usted a través de la API de Twitter ("Twitter Contenido") en relación con los productos o servicios que usted ofrece (su"Servicio") está sujeto y debe cumplir con estas Reglas. 2. Usted puede utilizar la API de Twitter y de contenido Twitter para desarrollar un servicio para buscar, visualizar, analizar, recuperar, ver y presentar la información o en Twitter. Usted puede utilizar el nombre de Twitter o los logos y marcas de otros elementos que pone a disposición de Twitter con el fin de identificar la fuente de Twitter de contenido ("Twitter Marcas"), sujeta a las presentes Reglas. 3. El uso de la API de Twitter Twitter y contenido están sujetos a ciertas limitaciones de acceso, llamadas, y el uso de la API de Twitter como se establece en dev.twitter.com o cuando se prevea a

Upload: manuel-aranda-mejia

Post on 24-Jun-2015

940 views

Category:

Documents


7 download

TRANSCRIPT

Page 1: Documentacion Twitter

Directrices y Condiciones Desarrollador Directrices, normas de circulación, y Términos de Servicio

Mostrar Directrices

Geo Directrices para desarrolladores

Desarrollador Reglas del CaminoTwitter sostiene una plataforma abierta que apoya a los millones de personas en todo el

mundo que está compartir y descubrir lo que está sucediendo ahora. Queremos potenciar

a nuestros socios del ecosistema para establecer negocios alrededor de la valiosa

información que fluye a través de Twitter. Al mismo tiempo, nuestro objetivo es lograr un

equilibrio entre el fomento de desarrollo interesante y proteger tanto a Twitter y los

derechos de los usuarios.

Así, hemos llegado con un conjunto de reglas para desarrolladores de la carretera

("Reglas") que se aplican a todos los desarrolladores y empresas de construcción

productos y servicios que interactúan con Twitter. Si usted es un usuario de los servicios

de Twitter, pero no un desarrollador, estas normas solo se verá lo que nuestros socios

están autorizados a ver con el contenido y la información que comparte con Twitter.

El Reglamento deberá evolucionar junto con nuestros ecosistemas como los

desarrolladores de seguir innovando y buscar formas nuevas y creativas para utilizar la

API de Twitter, así que por favor revise periódicamente para ver la versión más actual. Si

usted está haciendo algo prohibido por las Normas, hablar con nosotros acerca de si

deberíamos hacer un cambio o que se haga una excepción.

I. acceso a la API1. Todo uso de la API de Twitter y el contenido, documentación, código y otros materiales

relacionados a disposición de usted a través de la API de Twitter ("Twitter Contenido") en

relación con los productos o servicios que usted ofrece (su"Servicio") está sujeto y debe

cumplir con estas Reglas.

2. Usted puede utilizar la API de Twitter y de contenido Twitter para desarrollar un servicio

para buscar, visualizar, analizar, recuperar, ver y presentar la información o en

Twitter. Usted puede utilizar el nombre de Twitter o los logos y marcas de otros elementos

que pone a disposición de Twitter con el fin de identificar la fuente de Twitter de contenido

("Twitter Marcas"), sujeta a las presentes Reglas.

3. El uso de la API de Twitter Twitter y contenido están sujetos a ciertas limitaciones de

acceso, llamadas, y el uso de la API de Twitter como se establece en dev.twitter.com o

cuando se prevea a usted por Twitter. Si Twitter razonablemente cree que usted ha tratado

de superar o evitar los límites de velocidad, su capacidad para utilizar la API de Twitter y

de contenido Twitter puede ser temporal o permanentemente bloqueada.Twitter puede

monitorear el uso de la API de Twitter para mejorar el servicio de Twitter y para asegurar

su cumplimiento con el presente Reglamento.

4. No intento o animar a otros a:

(A vender), alquilar, arrendar, sublicenciar, distribuir, o sindicato de la API de Twitter

Twitter o Contenido a cualquier tercero por dicha parte a desarrollar productos o servicios

adicionales sin la aprobación previa por escrito de Twitter;

(B) suprimir o alterar cualquier aviso o marcas en la API de Twitter o de contenido Twitter;

Page 2: Documentacion Twitter

(C) el uso o acceso a la API de Twitter para efectos de control de la disponibilidad, el

rendimiento o funcionalidad de cualquier de los productos y servicios de Twitter, o por

cualquier evaluación comparativa a otros fines de la competencia, o

(D) el uso de Twitter Marcas como parte del nombre de su empresa o servicio, o en

cualquier producto, servicio o logotipos creados por usted.Usted no puede usar Twitter

marcas de una manera que crea una sensación de respaldo, patrocinio, o falsa asociación

con Twitter. Todo uso de Twitter Marcas, y todos de buena voluntad que surjan de dicho

uso, redundará en beneficio de Twitter.

II. PRINCIPIOSLe pedimos que usted y su Servicio de seguir cuatro principios:

No sorprende usuarios

No cree o distribuir spam

Respetar la privacidad del usuario

Ser un buen socio en Twitter

1. No sorprende usuarios

(A) Mantener la integridad de los píos. Hay una gran cantidad de información embalado en

tweets a pesar de que son sólo 140 caracteres de longitud (es decir, las relaciones con los

nombres de usuario, etc.) Las Directrices de visualización proporcionar orientación sobre la

forma de transmitir mejor toda la información prevista en un Tweet. Algunos puntos a

destacar:

o No modificar o revisar el contenido generado por el usuario a través de la entrega de la

API, excepto lo necesario debido a limitaciones técnicas o requisitos de cualquier red,

dispositivos, servicios o medios de comunicación.

o Identificar al usuario de que autor o en un Tweet a menos que ya sea proporcionando

tweets de manera agregada, o necesita hacer tweets anónima debido a la privacidad de

los usuarios o los problemas de seguridad.

(B) Obtener permiso de los usuarios antes de:

o enviar tweets o mensajes en su nombre. Un usuario que se autentica a través de su

aplicación no constituye un consentimiento para enviar un mensaje.

o modificar su información de perfil o teniendo en cuenta las acciones (incluidas las

siguientes, unfollowing, y el bloqueo) en su nombre.

o hashtags añadiendo anotaciones de datos, o de otros contenidos en Tweet de un

usuario. Si la aplicación permite a los usuarios enviar tweets o de otros contenidos a

Twitter, mostrar al usuario exactamente lo serán publicados.

(C) Su aplicación no debe:

o nombres comerciales uso y / o signos distintivos de una manera que puede inducir a

error, confundir o engañar a los usuarios. Para obtener más información sobre el uso de

Twitter Marcas, consulte nuestras directrices de uso de marcas registradas aquí

o confundir o inducir a error a los usuarios sobre el origen o propósito de su aplicación.

o el uso de aplicaciones como su dirección web no relacionadas una URL, un sitio

destinado a atraer o animar a los usuarios a violar nuestras normas, un spam o en el sitio

de malware, o un URL más corto para ocultar el verdadero destino.

o replicar, marco, ni tampoco copiar la página web de Twitter o su diseño.

Page 3: Documentacion Twitter

o suplantar la identidad o facilitar la suplantación de otros de una manera que puede

inducir a error, confundir o engañar a los usuarios.

(D) El respeto de la privacidad y la configuración de uso compartido de contenido de

Twitter. Inmediatamente cambiar su tratamiento de Twitter de contenido (por ejemplo, las

supresiones, modificaciones y opciones para compartir) los cambios se informó a través de

la API de Twitter.

2. No cree o distribuir spam

(Un spam) puede tomar muchas formas. Por favor, respetar las reglas de spam aquí.

(B) Si la aplicación realiza acciones automáticas (incluyendo otras actualizaciones del

contenido o piar), asegúrese de cumplir con las reglas de automatización encontrado aquí.

(C) No registrar las solicitudes de masas. Esto incluye:

o la creación de fichas / aplicaciones con el fin de impedir que otros utilicen o vendan esos

nombres, u otro uso comercial.

o utilizar los alimentadores de los contenidos de terceros para actualizar y mantener las

cuentas bajo los nombres de los terceros.

o que presenten solicitudes múltiples con la misma función con diferentes nombres con el

fin de ponerse en cuclillas nombre.

(D) No facilitar o fomentar la publicación de:

o enlaces a contenido malicioso

o imágenes pornográficas u obscenas a las imágenes de perfil de usuario y las imágenes

de fondo

3. Respetar la privacidad del usuario

(A) Revelar claramente lo que está haciendo con la información que recolectamos de los

usuarios.

(B) Revelar claramente la hora de agregar información de localización del usuario de un

píos, ya sea como una etiqueta geográfica o datos anotaciones. Sea claro acerca de si va

a añadir un lugar o coordenadas específicas. Si la aplicación permite a los usuarios Tweet

con su ubicación asegúrese de que cumple con las mejores prácticas encontradas aquí.

(C) No solicitar claves de otro desarrollador de consumo o los secretos de los

consumidores si se guardarán fuera de control que los desarrolladores. Por ejemplo,

servicios en línea que piden estos valores a fin de proporcionar un "tweet-branding"

servicio no se admiten.

(D) No facilitar o fomentar la publicación de información privada o confidencial.

4. Ser un buen socio en Twitter

(A) Si visualiza tweets en un contexto fuera de línea, hacerlo de acuerdo con las directrices

(B) El respeto de las características y funcionalidades integrado con Twitter o incluidos en

el Contenido o la API de Twitter. No trate de interferir, interrumpir o desactivar cualquiera

de las funciones de la API de Twitter.

(C) Si la aplicación hace que las cuentas de usuario o induce a violar las reglas de

Twitter (por ejemplo, retweeting actualizaciones de spam, publicar repetidamente los

vínculos duplicados, etc), puede ser suspendido o cancelado. Hemos proporcionado

Page 4: Documentacion Twitter

algunas orientaciones en nuestro Prevención del Maltrato y la página de ayuda de

seguridad.

(D) El respeto de los derechos de propiedad intelectual de terceros.

(E) No usar el Twitter verificada insignia de la cuenta, el estado de cuenta verificado, o

cualquier otra categorización en las cuentas de usuario mejorada que los registrados a

usted por Twitter a través de la API.

III. CONECTAR CON DIRECTRICES TWITTERLas siguientes directrices se aplican si utiliza Conectar con Twitter para integrar la

funcionalidad de Twitter en el Servicio.1. Conectado con Twitter

Los usuarios finales deben ser presentados con la opción de acceder a Twitter a través del

protocolo OAuth. Los usuarios finales sin una cuenta de Twitter se debe dar la oportunidad

de crear una nueva cuenta de Twitter a lo dispuesto por Twitter. Usted debe mostrar la

opción Conectar con Twitter al menos tan destacado como el más importante de cualquier

otro tercero de redes sociales de inscripción o registro de marcas y marcas que aparecen

en el servicio.

2. General

(A) Si usted permite que los usuarios finales crear cambios sociales de su propio

servicio social o de un tercero de redes sociales, micro-blogging, o proveedor de

actualización de estado integrado en su Servicio ("Actualización"), también debe

mostrar una buena opción la publicación del mismo contenido (o un enlace si la

actualización no es un texto de 140 caracteres o más que) al servicio de Twitter.

(B) Si aparece mezclado con servicio de Actualizaciones píos, debe asegurarse de

que hacen referencia a Twitter Tweets como la fuente.

3. Twitter Identidad

Una vez que un usuario final ha autenticado a través Conectar con Twitter, usted debe

mostrar claramente la identidad del usuario final Twitter.Twitter identidad incluye pantalla

visible del avatar del usuario final, el nombre de usuario de Twitter, Twitter y una "marca de

t". Muestra de los seguidores del usuario final en el teléfono de Servicio de mostrar

claramente que la relación se asocia con el servicio de Twitter.

IV. USO COMERCIALNuestro objetivo es ofrecerle a usted, nuestro socio de los ecosistemas, con una política

que es clara y transparente sobre lo que puede hacer para obtener beneficios económicos

de su Servicio. Este es el mejor resumen en dos principios:

contenido de respeto al usuario - píos se puede utilizar en la publicidad, no como

publicidad.

experiencia de respeto al usuario - construir su servicio en todo el calendario, no en la

línea de tiempo.

Y ahora, por los detalles:

1. Twitter anuncios. Twitter se reserva el derecho a servir de publicidad a través de su

API ("anuncios de Twitter"). Si usted decide servir anuncios de Twitter una vez que

empiecen a cumplir ellos, vamos a compartir una porción de los ingresos por publicidad

con usted por nuestra corriente términos y condiciones a continuación.

Page 5: Documentacion Twitter

2. Publicidad alrededor de Twitter Contenido

(A) Le animamos a crear oportunidades de publicidad alrededor del contenido de Twitter

que son compatibles con el presente Reglamento. En los casos donde el contenido de

Twitter es la base principal de la venta de publicidad, le pedimos que compensar a

nosotros (recuperables en contra de cualquier tasas que deben pagarse a Twitter para

licencias de datos). Por ejemplo, puede vender los patrocinios o la marca en torno a los

gadgets o iframes que incluyen píos y otras visualizaciones personalizadas de Twitter. Por

favor, contacte con nosotros para preguntas e información en [email protected], o

para notificarnos de una oportunidad de publicidad.

(B) En general, usted puede anunciar su alrededor y en aplicaciones o sitios que muestran

píos, pero usted no puede colocar anuncios dentro de la línea de tiempo Twitter en su

servicio que no sean anuncios de Twitter.

(C) Su publicidad no puede parecerse o razonablemente ser confundida por los usuarios

como un Tweet.

(D) Usted puede hacer publicidad en las proximidades de la línea de tiempo Twitter (por

ejemplo, los anuncios de banner de arriba o por debajo de línea de tiempo), pero debe

haber una separación clara entre el contenido de Twitter y sus anuncios.

3. Cómo usar contenido Twitter. Usted debe obtener el permiso del usuario que creó el

Tweet si usted:

o quieren utilizar su Tweet en un bien duradero comerciales o producto (por ejemplo,

usando un Tweet en una camiseta o un poster o hacer un libro basado en tweets de

alguien), o

o crear un anuncio que implica el patrocinio o respaldo en nombre del usuario.

V. OTROS TÉRMINOS LEGALES1.Termination.

Usted puede cancelar cualquier licencia en el presente Reglamento, en cualquier momento

mediante el cese de su acceso a la API de Twitter y el uso de cualquier Contenido Twitter,

y eliminar todas las copias de la API de Twitter y de contenido Twitter como se describe a

continuación.Twitter puede inmediatamente suspender su acceso a la API de Twitter o

cualquier Contenido Twitter (o si es necesario, dar por terminado este acuerdo con usted)

en cualquier momento y sin previo aviso si usted incumple cualquier término o condición

en este acuerdo o no participar en actividades que Twitter determina razonablemente

puedan causar la responsabilidad a Twitter. Twitter también puede terminar cualquier

continuación licencias por cualquier razón con treinta (30) días de antelación (incluso por

correo electrónico a la dirección asociada con su cuenta) a ti. Twitter no será responsable

por los costos, gastos o daños que resulten de su terminación de este acuerdo. A la

terminación de este acuerdo, que rápidamente dejará de acceder y utilizar la API de

Twitter y de contenido de Twitter y se eliminarán todos los contenidos de Twitter y

cualquier otra información derivada de éste y todas las copias y partes del mismo, en todas

sus formas y tipos de medios de comunicación de su Servicio. Secciones 1 (4) y V de las

presentes Reglas sobrevivirán a la terminación del presente acuerdo.2.Confidentiality.

Usted puede tener acceso a información no pública determinadas, software y

especificaciones relativas a la API de Twitter ("Información Confidencial"), que es

Page 6: Documentacion Twitter

confidencial y propiedad de Twitter. Usted puede utilizar esta información confidencial sólo

cuando sea necesario en el ejercicio de sus derechos reconocidos en el presente

Reglamento. Usted no puede revelar cualquiera de esta información confidencial a

terceros sin el consentimiento escrito previo de Twitter. Usted acepta que proteger esta

información confidencial del uso no autorizado, el acceso, o la divulgación de la misma

manera que utilizaría para proteger su información confidencial y patentada de propios de

la misma naturaleza y en cualquier caso nada menos que con un grado razonable de

cuidado .3.Ownership; de votos.

3,1 Twitter. Usted reconoce expresamente que Twitter y sus usuarios finales en todo el

mundo mantienen todos los derechos, títulos e intereses sobre y para el contenido de

Twitter, incluyendo todos los derechos de propiedad intelectual sobre éste. Usted también

reconoce que, entre usted y Twitter, Twitter posee todos los derechos, títulos e intereses

sobre y para la API de Twitter, Twitter Marcas, y el servicio de Twitter (como de cualquier

trabajo o mejora derivados), incluyendo pero no limitado a la propiedad intelectual

derechos sobre ellos. Usted se compromete a no hacer nada incompatible con dicha

propiedad. Todos los derechos no mencionados expresamente aquí son retenidos. El

usuario acepta que no cuestionar la propiedad de Twitter, la validez de cualquier licencia

de uso, o de otra manera copiar o hacer uso de las Marcas de Twitter durante o después

de la terminación de este acuerdo, salvo en lo expresamente autorizado en el mismo. Si

usted adquiere ningún derecho sobre las Marcas de Twitter o cualquier otro similar marcas

de crear confusión, por ministerio de la ley o de lo contrario deberá, sin costo alguno para

Twitter, inmediatamente asignar tales derechos a Twitter.

3,2 Usted. En las relaciones entre usted y Twitter, que conservan todos los derechos en

todo el mundo, títulos e intereses sobre y para el Servicio, con exclusión de la API de

Twitter, Twitter Marcas, y el Servicio de Twitter (como de cualquier trabajo o mejora

derivados), incluyendo pero no limitado a todos los intelectuales derechos de propiedad en

el mismo. Usted puede proporcionar Twitter con observaciones sobre el contenido o la API

de Twitter Twitter o su evaluación y uso de los mismos. Usted acepta que Twitter y sus

representantes tendrán la libertad de copiar, modificar, crear trabajos derivados, exhibir

públicamente, publicar, distribuir, licenciar y sublicenciar, incorporar y utilizar de otra

manera la retroalimentación, incluyendo las obras derivadas de los mismos, para cualquier

y todos los comerciales y no fines comerciales, sin obligación de ningún tipo en su caso.4.Updates.

Twitter puede actualizar o modificar la API de Twitter, Reglamento, y demás términos y

condiciones, incluidas las Directrices para mostrar, de vez en cuando a su sola discreción,

publicando los cambios en este sitio o por lo contrario se le notifica (dicha notificación

puede ser por correo electrónico). Usted reconoce que estas actualizaciones y

modificaciones pueden afectar negativamente a cómo su accesibilidad a los servicios o se

comunica con la API de Twitter. Usted dispondrá de treinta (30) días a partir de dicha

notificación para cumplir con las modificaciones. Si cualquier cambio es inaceptable para

usted, usted solo tiene que terminar este acuerdo mediante el cese de toda utilización de

la API de Twitter y de contenido Twitter. Su acceso o uso continuado de la API de Twitter o

cualquier Contenido Twitter siguiente al período de 30 días se constituirá la aceptación

obligatoria de los cambios.5.Representations y Garantías; Responsabilidad.

Page 7: Documentacion Twitter

5.1 Declaraciones y Garantías. Usted manifiesta y garantiza que:

(A) usted tiene el poder y la autoridad necesarios para entrar en este acuerdo, y que el

desempeño de sus obligaciones no constituyen una infracción o que viole cualquier otro

acuerdo o los derechos de terceros derivadas de las mismas;

(B) usted mantendrá durante la vigencia de este acuerdo todos los derechos y licencias

necesarios con respecto a su servicio, y

(C) su servicio y su uso, distribución, venta y licencia, incluido el uso de cualquier licencia a

continuación, hace y seguirá cumpliendo con todas las extranjeras, federales, estatales y

leyes locales, reglas y regulaciones.

5.2 Responsabilidad. EL CONTENIDO Twitter, Twitter API, Y TODOS LOS PRODUCTOS

Y SERVICIOS OTROS TWITTER proporcionado a continuación SE PROPORCIONAN

"TAL CUAL" Y "TAL-DISPONIBILIDAD", SIN GARANTÍA DE NINGÚN TIPO. Twitter

rechaza cualquier garantía, ya sea expresa, implícita, legal, o no, incluido SIN

LIMITACIÓN, LAS GARANTÍAS DE COMERCIALIZACIÓN, NO INFRACCIÓN,

IDONEIDAD PARA UN PROPÓSITO PARTICULAR, Y CUALQUIER GARANTÍA O

CONDICIONES DERIVADAS DE NEGOCIACIÓN O USO DE COMERCIO. TWITTER NO

GARANTIZA QUE EL CONTENIDO Y TWITTER Twitter API y cualquier producto

TWITTER y servicios que dispensa en virtud de ella satisfacer todas sus REQUISITOS O

USO DE LOS DATOS QUE TALES Y TWITTER Twitter API esté libre de errores

INTERRUMPA, libre de virus, o Segura.6. Limitación de la responsabilidad.

EN NINGÚN CASO CON TWITTER SERÁ RESPONSABLE ANTE USTED DE DAÑOS

ESPECIALES, incidental, ejemplar, punitivo o DERIVADOS (INCLUYENDO LA PÉRDIDA

DE USO, DATOS O BENEFICIOS DE NEGOCIO) que surjan de o en conexión con este

Acuerdo o EL USO DE LA API de Twitter, CONTENIDO Twitter, Twitter u otros productos y

servicios si dicha responsabilidad surge de cualquier reclamación basada en contrato,

garantía, agravio (incluyendo negligencia), responsabilidad estricta u otra, y si o no se le

ha advertido DE LA POSIBILIDAD DE dicha pérdida o daño. Las limitaciones anteriores se

SOBREVIVIR Y aplicarán aun cuando cualquier RESARCITORIA especificado en este

acuerdo se comprueba que ha fallado a su propósito esencial. EN CUALQUIER CASO, LA

RESPONSABILIDAD GLOBAL DE TWITTER en virtud del presente acuerdo no exceda del

mayor de cien pesos ($ 100) o las tasas agregado que pagarse por el acceso a la API de

Twitter en el último año.7. Indemnización.

Usted deberá indemnizar, defender y Twitter, sus subsidiarias, afiliados, funcionarios y

empleados, libres de todo reclamo, daños, pérdidas, responsabilidades, acciones,

resoluciones, costas y gastos (incluyendo honorarios razonables de abogados)

presentados por un tercero que surja de o en conexión con: (a) cualquier acto u omisión

por usted, en relación con el uso de los Contenidos de Twitter, la API de Twitter, o las

Marcas de Twitter, (b) su uso del Contenido de Twitter, la API de Twitter, o el Twitter

Marcas fuera de lo expresamente permitido por este acuerdo; (c) su incumplimiento o

supuesto incumplimiento de cualquiera de los términos, las restricciones, obligaciones o

representaciones en virtud del presente acuerdo, o (d) su servicio. Usted asumirá el control

de la defensa y la resolución de cualquier reclamación sometida a su

indemnización. Twitter puede, sin embargo, en cualquier momento optar por tomar el

Page 8: Documentacion Twitter

control de la defensa y transacción de dicha reclamación.En cualquier caso, no espere

ninguna reclamación sin el consentimiento previo por escrito de Twitter.8. Varios.

Estas normas constituyen el acuerdo completo entre las partes con respecto al objeto y

sustituye y fusiona todas las propuestas, acuerdos y las comunicaciones

contemporáneas. Cualquier modificación a las Reglas de que debe estar en un escrito

firmado por usted y Twitter. Usted no puede ceder los derechos y obligaciones otorgados

en este documento, voluntariamente o por ministerio de la ley (incluyendo, sin limitación en

relación con una fusión, adquisición o venta de activos), salvo con el consentimiento

expreso y por escrito de Twitter, y cualquier intento de asignación en violación de este

párrafo es nula. Este acuerdo no crea en forma alguna asociación, organismo o empresa

conjunta. Este acuerdo se regirá e interpretará de acuerdo con las leyes del Estado de

California, sin tener en cuenta o la aplicación de conflicto de leyes o principios. Todas las

reclamaciones que surjan de o se relacione con este acuerdo se planteará exclusivamente

ante los tribunales federales o estatales del Condado de San Francisco, California,

EE.UU., y usted se somete a la jurisdicción personal en estos tribunales. Ninguna renuncia

por Twitter de cualquier convenio o derecho en virtud de este acuerdo será efectivo a

menos recordado en un escrito debidamente autorizada por Twitter. Si alguna parte de

este acuerdo se determina para ser inválida o inejecutable por un tribunal de jurisdicción

competente, dicha disposición se aplicará en la máxima extensión y las demás

disposiciones de este acuerdo permanecerán en pleno vigor y efecto.

REQUISITOS

1. Tweet Autor: El nombre del autor debe ser presentado como autor Twitter nombre de usuario o el nombre con el actual nombre de usuario. El nombre debe estar vinculada a usuario de Twitter en la página de perfil http://twitter.com/username, o dentro de la representación interna de servicio a su perfil de autor, lo que debería contener un enlace a usuario de Twitter de la página de perfil. El autor de nombre de usuario debe ser de estilo diferente que el texto Tweet y enlaces (en negrita, color, tamaño o en la convención tipográfica de otro tipo), y no debe ser precedido por un símbolo @.

2. @ Menciona: Menciones de otros nombres de usuario de Twitter debe enlazar con la página de perfil en http://twitter.com/username o dentro de la representación interna de servicio a su perfil de usuario, lo que debería contener un enlace a usuario de Twitter de la página de perfil.

3. Hashtags: Si alguno hashtags ('#' seguido por una cadena de caracteres) se mencionan en el Tweet, que debe enlazar con una página de resultados de búsqueda twitter.com para ese término de consulta o una representación interna de los resultados que contiene un enlace a la Twitter página de búsqueda.

4. URL: Si las URL están incluidas en el Tweet, deben ser hipervínculo y el hipervínculo debe vincular a la ubicación pasa a través de la API.URL de hipervínculo se muestra cuando mejor visualmente diferenciado (colores o subrayado).

Page 9: Documentacion Twitter

5. Branding: Si un Tweet se muestra de forma independiente, debe ser etiquetado ya sea con el logotipo de Twitter o "T" marca, o con la lectura del texto "El contenido de Twitter." Si se agrupan múltiples tweets, el logotipo de Twitter o "Contenido de Twitter" debe ser colocado en una proximidad cercana a los contenidos agrupados.

6. Tweet Caja: Si muestra una caja para que los usuarios de Tweet: "¿Qué está pasando?" se debe escribir sobre el campo de texto. Este cuadro de Tweet también debe estar bien cerca de tweets que incluyan el logotipo de Twitter, o el logo de Twitter debe estar presente dentro de la caja.

a. Tweet botón: el botón se debe mostrar y etiquetados como "Tweet" si el contenido es publicado exclusivamente a Twitter, o "Actualizar" si la dirección a otros servicios además de Twitter.

b. La cuenta de carácter: un recuento de caracteres ayuda a los usuarios una cuenta atrás para permanecer dentro de 140 caracteres

SUGERENCIASLas siguientes son sugerencias basadas sobre cómo buscar tweets en

Twitter. Usted puede encontrar que esto no es la más adecuada para mostrar los

datos que muestran, y animamos a su creatividad. Sin embargo, si usted está

buscando una dirección, por favor visite el siguiente:

Avatar y alineación: Mostramos el avatar del usuario en el lado izquierdo de la

Tweet. Resto de contenido Tweet está alineado a la izquierda, inmediatamente a la

derecha del avatar. El avatar vínculos usuario de Twitter en la página del perfil

de http://twitter.com/username.

Timestamp y Permalink: Esta información puede ser mostrado o el relativo, por

ejemplo, "2 minutos", o absoluta, por ejemplo, "8:45 de la mañana, 08 de julio"). La

marca de tiempo debe estar en su propia línea después del texto y con un estilo

diferente Tweet a ser menos prominente que el texto Tweet (color más claro y / o

menor tamaño). La marca de tiempo debe estar ligado a la página alojada permalink

Twitter para el individuo Tweet.

Colaborador: tweets publicados por cuenta de un contribuyente debe atribuirse a que

el usuario de edición. La atribución debe consistir en contribuyente el nombre de

usuario vinculada a la cuenta del contribuyente (por

ejemplo, http://twitter.com/username) o dentro de la representación interna de su

servicio de contribuyente del perfil del.

Fuente: Junto con la marca de tiempo y enlace permanente, usted puede optar por

mostrar el cliente o el medio por el cual se envió el Tweet (por ejemplo, "from web" o

"from web"). Si el cliente se suministra, por favor asegúrese de que lo vincula a la URL

de la página de que la fuente.

Píos múltiples: Si muestra tweets varios a la vez, pueden ser visualmente separados

por líneas horizontales, espacios vacíos, o color de fondo alternativo. El espacio vacío

debe ser proporcional a la altura total de la propia Tweet.

Píos múltiples, un autor: Encontramos que al mostrar tweets de múltiples del mismo

usuario, se ve mejor si la foto de perfil no se repite con cada Tweet. Mostrando un

avatar con el contenido del mismo usuario proporciona una experiencia más simple.

Orden cronológico: Por lo general, tiene sentido para los tweets que pueden

ordenarse en orden cronológico inverso (el último primero), pero entendemos que esto

siempre puede no ser la forma más pertinente para organizar Tweets. Cuando

Page 10: Documentacion Twitter

aparecen en una búsqueda u otros criterios (palabras clave, usuarios, o editoriales

otras limitaciones) tweets pueden ser ordenadas por los criterios.

Nombre con nombre de usuario: Si el nombre completo aparecerá junto al nombre de

usuario de Twitter, el nombre de usuario de Twitter se debe examinar visualmente

diferenciado (por ejemplo, el color o negrita) y más prominente.

Enlace de búsqueda: La información se convierte más detectable cuando una

búsqueda vínculos plazo a una búsqueda de Twitter página de resultados. Si usted

tiene un producto que devuelve resultados de búsqueda para píos, se recomienda que

los vínculos plazo de vuelta a la página de búsqueda de referencia en Twitter.

Directrices para el Uso de los Elementos de Marca Twitter

Las siguientes pautas generales para el uso de los Elementos de marca Twitter se

aplicarán con independencia de la solicitud, salvo acuerdo en contrario por el Twitter por

escrito (que puede ser por correo electrónico).

La legibilidad. Las palabras incorporadas en la marca siempre debe ser claramente

legibles, independientemente del proceso de impresión utilizado.

Espacio libre. Es importante que el logotipo tiene un espacio libre de un tercio del

tamaño del logotipo de la vuelta por todos lados. Así se mantiene la integridad del

logotipo y evita la congestión y la ilegibilidad.

Modificación n º. Excepto según lo dispuesto en el Acuerdo, el Twitter de marca

Elementos no puede ser modificado o combinado con cualquier otra característica,

incluyendo pero no limitado a, otros logotipos, palabras, gráficos, fotos, imágenes,

lemas, números, características de diseño o símbolos. características individuales de la

Page 11: Documentacion Twitter

marca Elementos Twitter no se puede utilizar como parte del diseño de cualquier otro

producto, el empaque del producto, la documentación o la publicidad.

Negación de avales. El uso de la Marca Elementos Twitter debe ser veraz, justo, y no

menosprecian al Twitter o sus productos y no puede crear una sensación de respaldo,

patrocinio, o falsa asociación con Twitter Twitter o los productos, servicios o tecnología.

Para más información sobre cómo utilizar las marcas de Twitter,

véase http://help.twitter.com/forums/26257/entries/77641.

Las muestras deben ser enviadas a:

Twitter Inc.

795 Folsom St., Sexto Piso,

San Francisco, CA 94103

Correo electrónico: [email protected]

IntroducciónPiar Con La localización es la próxima versión de la característica de etiquetado geográfico

de la API de Twitter. Ahora convertir lat / lon coordenadas en lugares reales (en particular,

los barrios y ciudades). Esto ayuda a proporcionar una experiencia más significativa para

los usuarios al hacer tweets más contextual. Por ejemplo, "Los fuegos artificiales!" es

mucho más relevante cuando se asocia con una ubicación: "Los fuegos artificiales!" desde

el barrio de SOMA en San Francisco, California. Esperamos con interés trabajar con el

ecosistema de desarrolladores para crear grandes experiencias en torno a esta

funcionalidad!

Privacidad del usuario y control del usuario de su información Ubicación

Para garantizar una buena experiencia y seguro, los desarrolladores deben ser sensibles a

la privacidad del usuario cuando se trata de su ubicación, así como garantizar la

coherencia en la línea de base "twitteando con ubicación" experiencia. Éstos son algunos

puntos clave a tener en cuenta que ayudan a proteger la privacidad del usuario y asegurar

que los usuarios entender el impacto de sus acciones:

Directrices Generales Los usuarios deben opt-in para utilizar el piar Con la función de localización (ubicación

de "encender").

Usuario debe dar permiso explícito para su ubicación exacta para que se muestre con

sus tweets. Si la función de ubicación de su cliente es "pegajoso" - es decir, una vez

que la localización es activada, es siempre de difusión, el nivel predeterminado

recomendado es para mostrar place_ids y sólo permiten a los usuarios a optar más

exacta para lat / lon en función de cada Tweet o como un escenario alternativo

específico. Si tiene una implementación existente de que sólo tiene las coordenadas

latitud muestra / lon, debe asegurarse de que los nuevos usuarios entienden que su

ubicación exacta se añadirá a tweets.

Debe quedar claro a los usuarios qué nivel de información sobre la ubicación, en su

caso, se mostrará en asociación con sus pío. Una manera de hacerlo es mostrando un

mapa de cómo esta información se mostrará ante el tweet de su publicación. Si latitud

exacta / lon es parte de la información publicada por el usuario en el cliente, debe

quedar claro para el usuario que sus coordenadas exactas serán publicados.

Los usuarios deben ser capaces de cargar o cambiar su ubicación antes de Twitter.

Los usuarios deben ser capaces de limpiar su lugar en cada tweet.

Page 12: Documentacion Twitter

Ejemplos específicosEjemplo 1: n º de latitud Además explícita / lon (este es el actual Twitter cliente Web UI)

1. Mostrar un enlace a "tu lugar" cuando un usuario compone un Tweet2. En el fondo, utiliza el Twitter reverse_geocode llamada a la API y pasar la

latitud, longitud, precisión de su revisión, y han preferido granularidad el usuario (que, por defecto, es "barrio");

3. Muestra el nombre del lugar por defecto (Twitter intentará ordenar estos de una manera que tiene sentido - el orden es tal que un cliente de Twitter sólo puede mostrar la lista sin necesidad de modificación);

4. Permitir al usuario seleccionar una ubicación diferente de la lista (por ejemplo el cambio de "SoMa, San Francisco" en "South Beach, San Francisco").

5. Importante: Ser transparente con el usuario si va a mostrar información de ubicación exacta. Dar al usuario la opción de optar por no mostrar lat exacta / lon coordenadas; Asegúrese de que esta es explícito para que el usuario sepa si la información de ubicación exacta en la pantalla.

6. Permitir que el usuario a la ubicación claro en cada Tweet.Ejemplo 2: Las implementaciones existentes geotagging

Una serie de aplicaciones cliente de Twitter tienen la característica de etiquetado

geográfico original (que sólo transmiten lat / Lons sin proporcionar place_IDs) aplicado. El

comportamiento por defecto de la API imita este comportamiento - es decir, como un

desarrollador, no necesita realizar ningún cambio en su aplicación existentes con el fin de

mantener el comportamiento que existe hoy. De hecho, si se limitan a transmitir una latitud

y longitud en coordenadas de Twitter, Twitter invertirá automáticamente códigos

geográficos que lat / lon y mostrar el place_ID para aquellas superficies que tenemos datos

disponibles.

La clave desde la perspectiva de la privacidad del usuario es asegurarse de que es

transparente para los usuarios que sus coordenadas exactas se están utilizando y se

muestra en Twitter. Una buena práctica para las aplicaciones existentes sería permitir a los

usuarios "claras" sus coordenadas exactas para cada tweet, así como optar por mostrar

place_IDs solamente en vez de las coordenadas exactas en su defecto, "pegajoso" de

ajuste.

Twitter de almacenamiento de datos de localización del usuarioTwitter almacenará los datos transmitidos por el cliente de la siguiente manera:

Twitter se guardar todos los datos que el usuario decida presentar públicamente a sus

seguidores. Esto es similar a la forma en Twitter tiendas de la marca de tiempo que

indique la fecha Tweet se hizo, es decir, si un usuario con tweets sus coordenadas

exactas, Twitter almacenará esta ubicación exacta junto con el Tweet durante el tiempo

que el Tweet existe (o hasta que haga clic el "borrar mi historial de ubicación" botón en

la página de configuración como se describe aquí.)

Si un usuario enciende tweeting con la ubicación, pero opta por no incluir las

coordenadas exactas en un Tweet, Twitter no se mostrará esta información a sus

seguidores. Si bien Twitter no se mostrará esta información en línea de tiempo de un

usuario, se pueden almacenar temporalmente los puntos exactos para seis meses.

ResumenLa adición de ubicación a un tweet añade una enorme cantidad de contexto y el valor

desde la perspectiva del usuario. Sin embargo, las implementaciones de la ubicación de su

Page 13: Documentacion Twitter

cliente debe tener cuidado de tener privacidad y la transparencia del usuario como un

factor clave en el diseño de un producto centrado en la localización.

Si usted tiene alguna pregunta o comentario acerca de la privacidad, la ubicación y otras

características geográficas, por favor [email protected]

Autenticación ¿Qué camino autorización debo elegir?

Autenticación

La transición de la autenticación básica para OAuth

OAuth Bibliotecas

OAuth FAQ

Listado de "Entra con Twitter"

¿Qué camino autorización debo elegir?Twitter es compatible con una pocas métodos de autenticación y con el paso de la

autenticación básica para OAuth usted puede preguntarse qué método debe utilizar. Al

elegir el método de autenticación para que utilice debe entender la forma en que afectará a

su método de experiencia de los usuarios y la forma de escribir su aplicación.

Algunos de ustedes ya saben qué tipo de método de autenticación que desea utilizar y

queremos ayudarle a comprobar que ha tomado la decisión correcta.Estamos aquí para ayudar.

Muchos desarrolladores tienen problemas para pasar de la autenticación básica para

OAuth.

Ver La transición de la autenticación básica para OAuth para una visión general del

proceso de conversión.

API RESTAplicaciones Web

Estar basado en navegador, una aplicación web o servicio es capaz de utilizar la web

completas basadas en proceso OAuth lo que significa que el usuario tiene la más suave de

los métodos de autenticación.

Para autenticar la aplicación web de Twitter que debe utilizar OAuth. Las solicitudes para

utilizar XAuth será rechazada.

aplicaciones web a menudo el apoyo de varios usuarios por lo que es importante manejar

la asociación de fichas OAuth a las identidades de usuario cuidadosamente. La manera de

hacer esto dependerá de su aplicación y la configuración.

Tercera Parte AplicaciónLas aplicaciones de terceros tales como Twitpic y Yfrogtambién utilizará OAuth para

comunicarse con la API de Twitter. Para el desarrollador cualquiera que desee incorporar u

ofrecer un servicio similar a estas aplicaciones se presentan algunos desafíos.

Convenientemente hay una manera de delegar de forma segura las solicitudes de la API

de Twitter en una aplicación y nombre usuarios conocido como OAuth Echo.

OAuth Echo le permite preparar una solicitud de OAuth y luego lo enviará al servicio de

terceros que, después de concluir las operaciones que tienen que hacer, eco de su

petición OAuth a la API de Twitter.

Escritorio y móviles Aplicaciones

Page 14: Documentacion Twitter

Móviles y aplicaciones de escritorio son más a menudo las aplicaciones de usuario único,

como las secuencias de comandos de línea de comandos y aplicaciones en un

teléfono. Para estas aplicaciones puede ser difícil de manejar una URL de devolución de

llamada si no imposible.

Si usted puede manejar una devolución de llamada en su aplicación se recomienda

encarecidamente el uso OAuthpara autorizar a los usuarios. Si no usted debe

considerarOut-of-band/PIN código de autenticación

Out-of-band/PIN código de autenticaciónPara las aplicaciones que realmente no puede manejar el proceso completo de Twitter

OAuth proporciona el código out-of-band/PIN modo de autenticación, también conocido

como oob.

Este flujo de autenticación es casi idéntico al OAuth completo excepto que en lugar de

dirigirse a su sitio web el usuario se presenta con un código PIN. Al usuario se le pedirá

que escriba el código PIN en la solicitud que después de este paso el intercambio

simbólico.

En el de flujo total OAuth este proceso manual es realizado por la dirección de devolución

de llamada y de forma transparente para el usuario final.

Autenticación XAuthLa forma menos deseada para autenticarse con Twitter esXAuth. Este método sólo está

disponible para aplicaciones móviles o de escritorio y tiene que pedir permiso para

usarlo.Además, para evitar confusiones es necesario tener claro que xauth para Twitter no

es el mismo que el XAuth (nota el cambio en la carta de caso).

Es importante entender que xauth sigue OAuth. La única diferencia es que usted no tome

la request_token yautorizar los pasos del flujo de OAuth.

xauth no es un simple reemplazo para la autenticación básica y sigue necesitando de que

sabe cómo firmar su solicitud.

Si aún desea utilizar xauth se puede leer más acerca de cómo solicitar el acceso y realizar

llamadas XAuth en nuestrouso de XAuth página.

API de búsquedaLa búsqueda de la API no requiere autenticación.

Streaming APIEl streaming API soporta tanto la autenticación básica y OAuth. Por el momento no hay

fecha en la que la autenticación básica se apagará para el streaming de la API por lo que

son libres de elegir el método que desee.

Si usted tiene acceso a la cuenta que desea utilizar con la API y desea utilizar OAuth usted

puede encontrar el acceso a las fichas de streaming que necesita bajo mi testigo de

acceso de su página de configuración de la aplicación en sus cuentas aplicaciones de

Twitter.

Información generalPara utilizar la API de Twitter, lo primero que tienes que hacer es registrar una aplicación

de cliente. Cada aplicación de cliente se registre se suministrarán una clave de los

consumidores y secreto. Este esquema de clave secreta y es similar a la privada y las

claves públicas utilizadas en protocolos como SSH para aquellos que están

familiarizados. Esta clave secreta y se utilizará, junto con una colección de OAuth en su

Page 15: Documentacion Twitter

lenguaje de programación que elijan, a firmar todas las solicitudes que realice en la

API. Es a través de este proceso de firma que confiamos en que el tráfico que se identifica

es que es en realidad usted.

Al 30 de junio de 2010, autoridades de base (pasando directamente un nombre de usuario

y contraseña para todas las solicitudes de la API) ya no serán admitidos. Las aplicaciones

web son alentados a utilizar plenamente OAuth para autenticar usuarios y actuar en su

nombre. De escritorio y aplicaciones móviles son animados a usar OAuth. Móviles y

aplicaciones de escritorio también se les da la oportunidad de utilizarXAuth, un medio para

el intercambio de un inicio de sesión y contraseña de un testigo de acceso. Para utilizar

XAuth, envíe una solicitud [email protected] con un montón de detalles acerca de su

solicitud y por qué XAuth es la mejor opción para él.

Para las aplicaciones de usuario con los casos de uso-single, ahora ofrecemos la

capacidad de emitir un token de acceso para su cuenta propia (y sus propias

aplicaciones). Puede generar estas claves de su solicitud de información páginas. Obtenga

más información sobre el uso de un token de acceso único.

Esta página está en construcción. Lo siento por ser todos los pre-web 1.0 en ustedes, la

gente.

El registro de una aplicación

Introducción a la OAuth o OAuth en Twitter

o Pide Firma

o La adquisición de una solicitud de token

o Envío al usuario a la autorización

o El intercambio de una solicitud de token para un token de acceso

o Usando el modo de out-of-band/PIN código para escritorio y aplicaciones móviles

Hacer una solicitud de recursos en nombre de un usuario

Con xauth para adquirir fichas de acceso

El uso de un token de acceso único

Un Glosario OAuth

Solución de problemas

OAuth bibliotecas y otros recursos

El registro de una aplicaciónCrear una aplicación de la aplicaciones cliente página. Es muy rápida y fácil de hacer. El

registro de su aplicación nos permite identificar su aplicación. Recuerde que nunca revelan

sus secretos de los consumidores.

Al crear una aplicación, se le preguntó si su solicitud es un escritorio o de web de la

aplicación. Las aplicaciones de escritorio no es necesario introducir una dirección URL de

devolución de llamada. De hecho, las aplicaciones web no es necesario suministrar una

dirección de devolución de llamada tampoco. Una mejor práctica es siempre nos envíe

un oauth_callback_url en cada petición que paso simbólico, declarar explícitamente lo

que quiere la devolución de llamada a ser. En caso de que desea invocar lo que se llama

el PIN / de banda de flujo hacia fuera, usted se sirva un oauth_callback_url de

"oob". Consulte esta sección para más información sobre el flujo de código PIN.

Introducción a la OAuth

Page 16: Documentacion Twitter

Twitter se utiliza la autenticación abierta estándar OAuth para la autenticación. Para

obtener más información sobre OAuth, recomendamos la lectura del guía en Hueniverse, y

esta presentación SlideShare.

Autenticación con OAuth es más fácil si utiliza una biblioteca en su lenguaje de

programación favorito.

El ciclo de petición OAuth es más o menos:

Recuperar una solicitud de token

Solicitud de autorización de usuarios  mediante el envío al usuario a una página de

acceso Twitter.com

Cambio de la solicitud de token para un token de acceso

El flujo varía ligeramente al utilizar una aplicación de escritorio con lo que se llama el flujo

de "PIN-mode" o las credenciales de inicio de sesión mediante el intercambio de xauth.

Este diagrama ilustra aún más:

OAuth ofrece dos maneras de proporcionar métodos de autenticación OAuth: cadena de

consulta, y los encabezados HTTP. Se recomienda que utilice el enfoque de cabecera,

como la que separa a las preocupaciones y hace que la depuración mucho más fácil para

usted.

OAuth en Twitter

Page 17: Documentacion Twitter

OAuth puede ser confuso porque hay algunas variantes diferentes sobre cómo

funciona. Aquí hay una comida para llevar algunos detalles importantes del equipo:

Utilice encabezado basado OAuth - OAuth prevé significa pasar parámetros

relacionados con OAuth en una cadena de consulta o que les proporcione una

autorización de cabecera HTTP. Twitter prefiere basada en autenticación de cabecera

porque separa las preocupaciones, hace que la depuración más fácil, y evita los

problemas habituales de bajo o más URL escapar parámetros. OAuth mayoría de las

bibliotecas le permiten elegir qué tipo de OAuth está ejecutando. Vaya por el oro. Ir de

cabecera con sede OAuth.

Usar SSL para / OAuth / puntos finales * - para todos los pasos de la danza como

OAuth request_token, access_token, y autorizar, utiliza SSL

api.twitter.com uso - para todos tus pasos OAuth, utilice api.twitter.com como el

nombre de host, no sólo "twitter.com"

Siempre use un oauth_callback explícita - Se recomienda que especifique un OAuth

de devolución de llamada por defecto en su registro de cliente, pero declaran

explícitamente su oauth_callback en cada solicitud token buscar solicitar su aplicación

hace. Al establecer su dinámica oauth_callback, se puede pasar información de estado

adicional de nuevo a su aplicación y control de la mejor experiencia. Si se utiliza el flujo

del código PIN, especifique su oauth_callback como "fuera de banda".

Pide FirmaTodas las peticiones OAuth 1.0A utilizan el mismo algoritmo de base para la creación de

una cadena de base de la firma y una firma.

La cadena de base de la firma es a menudo la parte más difícil de OAuth para los recién

llegados para construir. La cadena de base de la firma está compuesta por el método

HTTP utilizado, seguido de un signo ("&") y luego la codificación URL base-URL que se

accede, con ruta de acceso (pero no los parámetros de consulta), seguido de un signo ("&

"). Luego, se toma todos los parámetros de consulta y el cuerpo parámetros POST

(cuando el cuerpo es de la POST con codificación tipo de dirección URL, de lo contrario el

cuerpo es ignorado POST), incluidos los parámetros OAuth necesaria para una

negociación con la solicitud que nos ocupa, y clasificarlos en lexicográfico Para primero y

luego el nombre del parámetro por parámetro de valor (por duplicado parámetros), al

mismo tiempo garantizar que la clave y el valor de cada parámetro URL codificada de

forma aislada. En lugar de utilizar el signo igual ("=") para marcar la clave / valor de la

relación, se utiliza la forma codificada URL de 3D "%". Cada parámetro es tarde la URL

con caracteres de escape signo signo "% 26".

Este algoritmo se expresa simplemente en el pseudo-código:

+ HttpMethod "y" + url_encode (base_uri) + "&" sorted_query_params.each + (k |, v | url_encode (k) + "3D%" url_encode + (v)). Join ("% 26")

No importa qué tipo de OAuth 1,0 solicitud que está haciendo, las normas para la

generación de la cadena de base de la firma se mantienen constantes.

Twitter requiere que todas las solicitudes OAuth se firme utilizando el algoritmo HMAC-

SHA1.

La adquisición de una solicitud de token

Page 18: Documentacion Twitter

El primer paso para autenticar a un usuario es la obtención de una solicitud de token de

Twitter. Este paso sirve para dos propósitos: Primero, para decir lo que Twitter está a

punto de hacer. En segundo lugar, decirle a Twitter lo que quiere hacer por la devolución

de llamada OAuth.

Twitter es el punto final de la solicitud es el paso

simbólico http://api.twitter.com/oauth/request_token.

Debe utilizar el POST método HTTP cuando se utiliza este punto final. SSL es

recomendable.

Vamos a realizar una petición de solicitud de token utilizando HTTPS, POST, las

siguientes variables y el secreto de los consumidores

"MCD8BKwGdgPHvAuvgvz4EQpqDAtx89grbuNMRd7Eh98":

oauth_callback- http://localhost:3005/the_dance/process_callback?

service_provider_id=11

oauth_consumer_key- GDdmIQH6jhtmLUypg82g

oauth_nonce- QP70eNmVz8jvdPevU3oJD2AfF7R7odC2XJcn4XlZJqk

oauth_signature_method- HMAC-SHA1

oauth_timestamp- 1272323042

oauth_version- 1,0

En primer lugar, clasificar todos los parámetros utilizados en nuestra solicitud y formular

una cadena de base de la firma. Tenga en cuenta que mi oauth_callback tiene parámetros

de consulta en la URL. Debido a que los parámetros de consulta son parte de la dirección

de devolución de llamada, que no se clasifican junto con los otros parámetros en la

solicitud. En cambio, la dirección URL es una URL codificada y consideró una sola

cadena. Esto se basa la cadena de la firma de bases siguientes:

POST y https% 3A% 2F%%% 2Fapi.twitter.com 2Foauth 2Frequest_token &% oauth_callback% 253A% 252F 3Dhttp 252Flocalhost%%% 253A3005% 252Fthe_dance 252Fprocess_callback% 253Fservice_provider_id% 253D11% 26oauth_consumer_key 3DGDdmIQH6jhtmLUypg82g%%%% 26oauth_nonce 3DQP70eNmVz8jvdPevU3oJD2AfF7R7odC2XJcn4XlZJqk 26oauth_signature_method% 3DHMAC-SHA1%% 26oauth_timestamp 3D1272323042% 26oauth_version% 3D1.0

Dado que esta solicitud no tiene un oauth_token o oauth_token_secret, no figurará un

campo oauth_token en nuestra cadena de base y no usamos un oauth_token_secret la

hora de calcular la clave de firma compuesto. Nuestra clave es la firma (nótese el signo

colgando al final):

MCD8BKwGdgPHvAuvgvz4EQpqDAtx89grbuNMRd7Eh98 &

Después se utiliza la firma clave compuesta para crear un oauth_signature de la cadena

de base de la firma mediante la firma de la cadena de base con la clave de firma

compuesto. El oauth_signature resultante es:

8wUi7m5HFQy76nowoCThusfgB + Q =

Ahora que tenemos nuestra firma, tenemos todo lo necesario para realizar la solicitud al

extremo https: / / api.twitter.com / OAuth / request_token. Ahora sólo generan una

cabecera HTTP llamada "autorización" con los correspondientes parámetros OAuth de la

solicitud:

Page 19: Documentacion Twitter

OAuth oauth_nonce = "QP70eNmVz8jvdPevU3oJD2AfF7R7odC2XJcn4XlZJqk", oauth_callback = "http% 3A% 2F% 3A3005 2Flocalhost%%% 2Fthe_dance 2Fprocess_callback% 3D11% 3Fservice_provider_id", oauth_signature_method = "" HMAC-SHA1, oauth_timestamp = "1272323042", oauth_consumer_key = "GDdmIQH6jhtmLUypg82g", oauth_signature = "% 8wUi7m5HFQy76nowoCThusfgB 2BQ% 3D", oauth_version = "1.0"

Cuando recibe nuestra solicitud Twitter.com, responderá con

una oauth_token, oauth_token_secret (colectivamente, la "solicitud de token"), y un

campo llamado oauth_callback_confirmed que tendrá el valor de "true" si se comprende

su devolución de llamada OAuth. La respuesta a esta petición particular, habría parecido:

oauth_token 8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc = & = oauth_token_secret x6qpRnlEmW9JbQn4PQVVeVG8ZLPEx6A0TOebgwcuA y oauth_callback_confirmed true =

Ahora vamos a almacenar la oauth_token oauth_token_secret y por un corto período que

nosotros enviamos al usuario de que el servidor de autenticación. Vamos a necesitar esta

oauth_token oauth_token_secret y hasta los hemos cambiado por un token de

acceso. Apóyese en ellos.

Envío al usuario a la autorizaciónEsta es la parte más fácil del flujo estándar OAuth. Desde el paso anterior, usted

necesitará solamente su oauth_token (la solicitud de token) para completar.

El paso es autorizar a donde enviar al usuario a una página en Twitter.com que les permita

la concesión de sus privilegios de aplicación para que utilice su cuenta con la

API. Normalmente, una aplicación web simplemente usará un redireccionamiento para

enviar al usuario a la ubicación. Una aplicación de escritorio en el mismo podría presentar

la dirección y pedir al usuario a la libre navegación en el destino.

El punto final de la url autorización es https: / / api.twitter.com / OAuth / autorizar. Debe

tener un parámetro de consulta única adjunto llamado oauth_token con el valor establecido

en el oauth_token que recibió en la solicitud de paso simbólico. En el ejemplo anterior, el

oauth_token era "8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc". El uso de este

símbolo para generar una dirección URL de autorización en los resultados:

http://api.twitter.com/oauth/authorize?oauth_token=8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc

Si el usuario no ha iniciado sesión en Twitter recientemente, se le pedirá que introduzca

sus credenciales de la cuenta. De lo contrario, se le presentará con un flujo aerodinámico

que permite con un solo clic de autorización para su aplicación. Una vez que el usuario

tiene acceso, el control será devuelto a su solicitud de redirigir al usuario a su

oauth_callback especificado. Si está utilizando una aplicación de escritorio y la salida de

flujo de banda, el usuario en lugar se presentará con un código PIN que se le pedirá que

introduzca en su aplicación. Vamos a ver cómo el código PIN se utiliza en el próximo paso.

Si está utilizando el flujo de devolución de llamada, su oauth_callback debería haber

recibido de vuelta a su oauth_token (el mismo que le envió, su "solicitud de token") y un

campo llamado oauth_verifier. Usted lo necesitará para el siguiente paso.

Aquí está la respuesta que recibí:

Page 20: Documentacion Twitter

oauth_token 8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc = & = oauth_verifier pDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY

El intercambio de una solicitud de token para un token de acceso¡Menos mal! Ya casi estamos consiguiendo hacer todo lo que necesitamos para hacer

realidad las peticiones de la API en nombre de un usuario. Todas las cosas buenas que ha

sucedido: usted ya ha empezado el baile al pedir una solicitud de token. Usted ha enviado

el usuario para autorizar y entonces todo lo que pasó, pasó ... Ahora necesita un testigo de

acceso para continuar. Usted necesitará su solicitud de fichas (oauth_token y

oauth_token_secret) y oauth_verifier de los últimos pasos.

testigo de acceso del punto final Twitter es https: / / api.twitter.com / OAuth /

access_token

Aquí están todos los parámetros que se van a ir a nuestra solicitud para el intercambio de

acceso token:

oauth_consumer_key- GDdmIQH6jhtmLUypg82g

oauth_nonce- 9zWH6qe0qG7Lc1telCn7FhUbLyVdjEaL3MO5uHxn8

oauth_signature_method- HMAC-SHA1

oauth_token- 8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc

oauth_timestamp- 1272323047

oauth_verifier- pDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY

oauth_version- 1,0

Y aunque sólo se utiliza en la parte de firma de la solicitud, nuestro oauth_token_secret

siguex6qpRnlEmW9JbQn4PQVVeVG8ZLPEx6A0TOebgwcuA.

Vamos a realizar otra llamada SSL utilizando POST. Primero preparamos nuestra cadena

de base de la firma:

POST y https% 3A% 2F%%% 2Fapi.twitter.com 2Foauth 2Faccess_token &%% oauth_consumer_key 3DGDdmIQH6jhtmLUypg82g 26oauth_nonce%%% 3D9zWH6qe0qG7Lc1telCn7FhUbLyVdjEaL3MO5uHxn8 26oauth_signature_method 3DHMAC-SHA1%%%% 26oauth_timestamp 3D1272323047 26oauth_token% 3D8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc 26oauth_verifier% 3D1.0 3DpDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY%% 26oauth_version

Creamos una clave de firma compuesto utilizando nuestros dos oauth_consumer_secret y

nuestra oauth_token_secret (solicitud secreto token) por unirse a ellos con un signo:

MCD8BKwGdgPHvAuvgvz4EQpqDAtx89grbuNMRd7Eh98 y x6qpRnlEmW9JbQn4PQVVeVG8ZLPEx6A0TOebgwcuA

Luego de firmar nuestra petición, con la resultante firma OAuth:

PUw/dHA4fnlJYM6RhXk5IU/0fCc =

Ahora que tenemos nuestra oauth_signature, estamos listos para enviar el POST a

Twitter.com, por lo que creemos nuestro encabezado de autorización HTTP utilizando de

nuevo las correspondientes parámetros OAuth, incluido el oauth_token (token petición)

Page 21: Documentacion Twitter

estamos intercambio con tokens de acceso. Sus peticiones de recursos se va a parecer

muy similar a esta.

oauth_nonce OAuth = "9zWH6qe0qG7Lc1telCn7FhUbLyVdjEaL3MO5uHxn8", oauth_signature_method = "" HMAC-SHA1, oauth_timestamp = "1272323047", oauth_consumer_key = "GDdmIQH6jhtmLUypg82g", oauth_token = "8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc", oauth_verifier = "pDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY", oauth_signature = "% 3D% PUW 2FdHA4fnlJYM6RhXk5IU 2F0fCc%" , oauth_version = "1.0"

Cuando esto termine apretón de manos, Twitter responderá con más parámetros de

codificación URL, incluyendo el nombre de pantalla y el identificador de usuario que acaba

de autorizar, y una oauth_token y oauth_token_secret (colectivamente, el "testigo de

acceso"). Usted desea almacenar estos distancia. Puede utilizar un token de acceso hasta

que el miembro corta la conexión.

La respuesta en este ejemplo es:

oauth_token = 819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw oauth_token_secret & = & user_id = J6zix3FfA9LofH0awS24M3HcBYXO5nI1iYe8EfBA 819797 & = screen_name episod

Ahora voy a utilizar este token de acceso para enviar una situación en Twitter.com.

Hacer una solicitud de recursos en nombre de un usuarioAsí que ahora vamos a hacer un tweet. Vamos a utilizar el oauth_token y

oauth_token_secret desde el último paso y manda un tweet con algunos caracteres

especiales para hacer las cosas más complicado para usted.

Esto es lo que vamos a Tweet: "la creación de mi twitter 私のさえずりを設定する"

Esto utiliza caracteres UTF-8 a Tweet en Inglés y Japonés.

Mientras se enviaba este tweet, utilizamos el recurso

URL http://api.twitter.com/1/statuses/update.json y el método POST. Aquí están los

relacionados con params OAuth voy a utilizar y actualizar el estado real de la:

POST cuerpo- = ajuste de estado + hasta + + + mi twitter 私 の さえずり を 設定 する oauth_consumer_key- GDdmIQH6jhtmLUypg82g る oauth_nonce- oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y

oauth_signature_method- HMAC-SHA1

oauth_token- 819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw

oauth_timestamp- 1272325550

oauth_version- 1,0

Y ahora, la experiencia de déjà vu. Vas a crear una cadena de base de la firma, siguiendo

todas las reglas de antes - con excepción, estamos usando caracteres UTF-8 aquí y

necesidad de adminis-URL-las codifican. Mi cadena base será la siguiente:

POST y http% 3A% 2F% 2F1% 2Fapi.twitter.com%% &% 2Fstatuses 2Fupdate.json oauth_consumer_key% 3DGDdmIQH6jhtmLUypg82g 26oauth_nonce 3DoElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y%%%% 26oauth_signature_method 3DHMAC%-SHA1% 26oauth_timestamp% 3D1272325550 26oauth_token 3D819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw 26oauth_version%%%% 3D1.0 26status 3Dsetting 2520up%%% 2520my 2520twitter% 2520% 25E7% 25A7% 2581% 2581% 25E3% 25AE% 25E3% 2581% 2595% 2581% 25E3% 2588% 2581% 25E3% 259% 25E3% 2582% 258A% 25E3% 2582% 2592% 25E8% 25A8% 25AD% 25E5% 25AE% 259% 25E3% 2581% 2599% 2582% 25E3% 258B

Page 22: Documentacion Twitter

Ahora voy a crear una clave de firma compuesto utilizando tanto el

oauth_consumer_secret y el oauth_token_secret vinculada a mi testigo de acceso:

MCD8BKwGdgPHvAuvgvz4EQpqDAtx89grbuNMRd7Eh98 y J6zix3FfA9LofH0awS24M3HcBYXO5nI1iYe8EfBA

Y después de usar ese secreto para firmar mi cadena base, tengo la siguiente firma:

yOahq5m0YjDDjfjxHaXEsW9D + X0 =

Y ahora lo que necesito para crear mi cabecera HTTP de autorización, que por supuesto,

todos esos valores deben ser .. URL codificada

oauth_nonce OAuth = "oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y", oauth_signature_method = "" HMAC-SHA1, oauth_timestamp = "1272325550", oauth_consumer_key = "GDdmIQH6jhtmLUypg82g", oauth_token = "819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw", oauth_signature = "% yOahq5m0YjDDjfjxHaXEsW9D 2BX0% 3D", oauth_version = "1.0"

Y yo que enviar POST al punto final y espero que todo funciona. En un tweet con éxito, mi

respuesta incluye la carga habitual de un tweet con éxito - el propio tweet:

("Geo": null, "created_at": "Mon 26 de abril 0000 23:45:50 2010", "in_reply_to_user_id": null, "truncado": false, "lugar": null, "fuente": "<a href = \ "\ http://dev.twitter.com" rel = \ "nofollow \"> OAuth Bailarín </ a> "," Favoritos ": false," in_reply_to_status_id ": null," contribuyentes ": null," usuario ": (" contributors_enabled ": false," created_at ":" Miércoles 07 de marzo 0000 22:23:19 2007 "," descripción ":" La realidad Técnico, Desarrollador Abogado en Twitter, Invasor del espacio. "," geo_enabled ": true," notificaciones ": false," profile_text_color ":" 000000 "," después de ": false," time_zone ":" Hora del Pacífico (EE.UU. y Canadá) "," verificado ": false," profile_link_color ":" 731673 "," url ":" http://bit.ly/5w7P88 "," profile_background_image_url ":" http://a3.twimg.com/profile_background_images/19651315/fiberoptics.jpg "," profile_sidebar_fill_color ":" 007ffe ", "situación": "San Francisco, CA", "followers_count": 1220, "profile_image_url": "http://a3.twimg.com/profile_images/836683953/zod_normal.jpg", "profile_background_tile": true, "profile_sidebar_border_color" : "bb0e79", "protegido": false, "friends_count": 1275, "screen_name": "episod", "name": "Taylor Singletary", "statuses_count": 5733, "id": 819797, "lang": "es", "utc_offset": -28800, "favourites_count": 89 ", profile_background_color": "000000"), "in_reply_to_screen_name": null, "coordenadas": null, "id": 12912397434, "text": "establecer mi twitter \ u79c1 \ u306e \ u3055 \ u3048 \ u305a \ u308a \ u3092 \ u8a2d \ u5b9a \ u3059 u308b \ ")

Vamos a hablar cuando las cosas van mal en un momento ..

OAuth Glosario oauth_nonce - un identificador único para su solicitud, creado por usted. Twitter sólo

permitirá un nonce para ser utilizada una vez por su aplicación. Evita que reproducen

las solicitudes.

oauth_timestamp - un entero que representa el número de segundos que han

transcurrido desde la época Unix.

Page 23: Documentacion Twitter

oauth_verifier - una cadena enviada a usted en su devolución de llamada OAuth o

suministrado a un usuario en el flujo de autenticación, dependiendo de si está

utilizando fuera del modo de banda o no. Tiene la obligación de ser enviados sobre el

acceso paso simbólico.

salir del modo de banda - En lugar de proporcionar una base URL de llamada en la

adquisición de una solicitud modo, "fuera de banda" se suministra. Una vez que el

usuario haya dado su Twitter credenciales de la cuenta, aunque se presenten con una

pantalla que contiene un código PIN y se le solicitará que introduzca el código en la

aplicación. La aplicación envía el PIN como oauth_verifier al acceso token paso para

completar el intercambio.

la firma cadena base - una cadena de montaje que se firme utilizando una clave de

firma para crear una firma. En OAuth 1.0A, la cadena de base de la firma se calcula

como:

+ HttpMethod "y" + url_encode (base_uri) + "&" sorted_query_params.each + (k |, v | url_encode (k) + "3D%" url_encode + (v)). Join ("% 26")

parámetros de consulta, en este caso se incluyen tanto los parámetros de consulta

pasa al base_uri en la cadena de consulta o en post-codificados URL órganos, así

como todos los parámetros relevantes de OAuth pertinentes a la solicitud en

movimiento, ordenados en orden lexicográfico. Si varias teclas están presentes con

diferentes valores, deben ser ordenados por el primer valor. POST organismos que no

son del tipo de dirección URL codificada no se calculan como parte de la base de

cadena de firma OAuth.

clave de firma - la cadena que se utiliza como la clave secreta "para firmar una

petición. En OAuth 1.0A, la clave de firma se calcula con el algoritmo simple siguiente:

url_encode (consumer_secret) + "&" url_encode + (oauth_token_secret | | nulas)

Algunas solicitudes implican un oauth_token_secret OAuth, y otros no. La clave de

firma siempre es la combinación de ambos y su consumer_secret oauth_token_secret

uno, separados por un signo. Cuando no hay oauth_token_secret, aún tiene que crear

una clave de firma compuesta que incluya el signo seguido de "nada".

La transición de la autenticación básica para OAuth no es simple para todos. Va desde una

perspectiva en enviar un nombre de usuario y contraseña con todos los API REST solicitud

que realice en uno en el que eres el primero que con una autorización del usuario, y luego

enviar las credenciales que identifican a la aplicación y el usuario en cada solicitud .Estamos aquí para ayudar.

Muchos desarrolladores tienen problemas con OAuth. Buscar temas OAuth ohacer una

pregunta en la lista de correo de desarrolladores nuestra si llegas a tener problemas.

Las diferencias entre Basic Auth y OAuthSi usted piensa de una solicitud de API como un sobre de correo estándar:

La autenticación básicaEn la autenticación básica sólo es necesario proporcionar una dirección de retorno "(el

nombre de usuario y contraseña), y la dirección del destinatario (el recurso que está

Page 24: Documentacion Twitter

accediendo a) - de vez en cuando relleno el sobre con algunos datos que es pertinente a la

solicitud de la API que están haciendo.

Todo en este contexto es tan simple como enviar una carta. Envío es gratuita, pero sólo se

puede enviar tantas "cartas" antes de su cuota (límite de velocidad) se agota.Aspectos de la autenticación básica con la API de Twitter

La aplicación cliente debe almacenar entrada del usuario y la contraseña

La aplicación cliente debe enviar entrada del usuario y la contraseña a cada solicitud de

Si cambia la contraseña del usuario, la aplicación cliente debe adquirir una nueva

contraseña para el usuario

El usuario no tiene medios para descubrir qué aplicaciones basadas en autenticación

básica-tienen su nombre de usuario y contraseña

El usuario no tiene capacidad de restringir una aplicación de uso de su cuenta después

de dar su nombre de usuario y contraseña

La aplicación cliente tiene una identidad muy débil dentro del ecosistema de Twitter.

variables POST, los parámetros de consulta, y la URL de la solicitud puede ser

modificada en cualquier etapa del ciclo de petición sin invalidar la solicitud

peticiones reproducido no se pueden prevenir

La autenticación básica es un pasivo. En los inicios de sesión y contraseñas de

almacenamiento, un desarrollador asume responsabilidades adicionales para el

almacenamiento seguro de las credenciales, el daño potencial a los usuarios si las

credenciales de acceso se filtran o abuso es muy alto. Debido a que muchos usuarios

utilizan la misma contraseña en muchos sitios, el potencial de daño no necesariamente

termina con su cuenta de Twitter.

OAuth autenticaciónOAuth autenticación es un poco más compleja en esta metáfora.

Page 25: Documentacion Twitter

Si bien todavía la dirección de la dotación al mismo destinatario (el recurso), se identifica

su solicitud a la procedente de ambos el usuario que realiza la solicitud y la aplicación que

está trabajando en nombre del usuario. Además, debe proporcionar una marca de

"post" de todo tipo, describiendo el momento de la "carta" fue enviado y el contenido

efectivo de la dotación. De alguna manera, esta es la principal diferencia entre los métodos

de acceso.Aspectos de autenticación OAuth con la API de Twitter

La aplicación cliente no necesita almacenar un nombre de usuario y contraseña

La aplicación cliente delegados autorización a una ubicación de confianza, es decir,

https: / / api.twitter.com / OAuth / autorizar

La aplicación cliente envía un token de acceso que representa al usuario con cada

solicitud en lugar de un usuario y contraseña

variables POST, los parámetros de consulta, y la URL de la solicitud debe permanecer

intacto para una solicitud de completar con éxito (la oauth_signature no puede ser

verificada a menos que todos los elementos de la solicitud de mantener sus cualidades

originales en el momento de la generación de firma)

Si cambia la contraseña del usuario, la aplicación cliente continúa funcionando

El usuario tiene el control de qué aplicaciones pueden actuar en su nombre y se puede

suprimir la autorización concedida en cualquier momento

Su aplicación es una entidad conocida en el ecosistema, con beneficios tanto

realizadas como para venir en el área de análisis, la atribución, y mucho más.

peticiones reproducido se vean afectadas por un identificador único para cada solicitud

(el oauth_nonce)

Con estas comparaciones en cuenta, debe quedar claro que la migración a OAuth es

generalmente un proceso más intenso que solo cambiando unas pocas líneas de código -

y depende en gran medida el lenguaje de programación y los marcos se utilizan, además

de lo que las bibliotecas de la API de interfaz son en juego.

¿Por dónde empezar?Auditoría de las solicitudes de la API de su aplicación lleva a cabo

Page 26: Documentacion Twitter

Cualquier autenticación que requieren llamadas a la API que hace (como estados /

home_timeline, estados / menciona, estados / actualización, etc) deberán ser convertidos

al uso de OAuth. Mientras que usted podría optar por mover sólo a OAuth para las

operaciones que requieren autenticación de usuario, se recomienda que convertir todas

sus llamadas a la API a la utilización de OAuth para que su aplicación (y su nombre de

usuario) son siempre identificados en cada solicitud.Elegir un OAuth o biblioteca Twitter OAuth, listo para su entorno de programación

Mientras que usted podría ir a la molestia de la aplicación de todos los pormenores del

protocolo OAuth (y HMAC SHA1-) a ti mismo, no es recomendable. Consulte nuestra lista

de Bibliotecas OAuth y Bibliotecas Twitter para encontrar una biblioteca adecuada para

usted.

Si realmente desea crear su propia biblioteca le recomendamos que para construir una

aplicación que funciona utilizando las bibliotecas existentes primero. De esta manera,

cuando se hace rodar su propia solución tiene una aplicación de trabajo para comparar

con éxito en caso de que ningún problema.Preparar a largo plazo de almacenamiento de tokens de acceso y los secretos

Sea cual sea su sistema de almacenamiento puede ser, usted tendrá que empezar a

almacenar una oauth_token y oauth_token_secret (en conjunto, un acceso "token") para

cada usuario de su aplicación. El oauth_token_secret se deben almacenar de forma

segura. Recuerde, usted será el acceso a estos valores para cada solicitud autenticada de

su uso hace a la API de Twitter, así que almacenan de forma que se escala en su base de

usuarios. Cuando usted está utilizando OAuth, usted debe dejar de almacenar contraseñas

para cualquiera de sus usuarios.Elegir e implementar la autenticación de su patrón

Hemos reunido una mini-guía titulada "¿Qué camino autorización debería elegir?" que

presenta los distintos métodos de OAuth apoyamos para obtener la autorización de

usuarios - el proceso en el que un usuario otorga su permiso de fin de solicitud para actuar

en su nombre a través de un volvió testigo de acceso.

Si bien la aplicación del presente, tendrá que prepararse para una variedad de diferentes

tipos de OAuth firmado peticiones que son representativos de los otros tipos de llamadas

le toma.Migra tus llamadas a la API a través de firmas OAuth

Ahora que ha preparado su aplicación OAuth, tendrás que pasar por todos los lugares en

su código en caso de que estás utilizando la autenticación básica y OAuth usar en su

lugar. Al igual que todas las partes del flujo de OAuth, esto es en gran medida el lenguaje y

dependen de la biblioteca. Algunos OAuth o bibliotecas Twitter se hará cargo de todos los

tornillos y tuercas de estos pasos para usted.

Solución de problemasHay más de algunas maneras para una solicitud de OAuth a ir mal. Estos son algunos

consejos para reducir la posibilidad de errores.

Compruebe que está utilizando el método de derecho de solicitud HTTP. La mayoría de

los métodos en la API de Twitter requieren un POST o GET.

Si va a generar su propia nonce (número que se usa una vez), asegúrese de incorporar

el tiempo y algún tipo de ID aleatorio. Para minimizar el riesgo de enfrentamientos entre

Page 27: Documentacion Twitter

los distintos usos nonce de su aplicación es posible que desee también decidió

incorporar algo único a la máquina.

Compruebe el orden de los parámetros que enviar la solicitud son los mismos que

estaban cuando se generó la firma OAuth.

Asegúrese de que fecha y hora de su sistema está en sincronía con Twitter. Volvemos

la hora actual en una cabecera HTTP con todas las solicitudes.

Lecturas ¿Qué camino autorización debo elegir?

La aplicación de Twitter OAuth

OAuth Bibliotecas

Twitter Bibliotecas

Con xauth con Twitter OAuth

El uso de un token de acceso único con Twitter OAuth

Guía del principiante para OAuth

OAuth 1.0A Especificaciones

Presentaciones sobre OAuth en SlideShare

Demasiados secretos, pero nunca es suficiente: Twitter OAuth (de Pío 2010)

En XAuth y mucho más en la WWDC 2010 Twitter Meetup

Cómo evitar la pérdida de los pantalones con OAuth  por Jesse Estancia

OAuth: Zero to Hero  - Si bien particular de OAuth aplicación LinkedIn, la mayoría de los

ejemplos son portables a la utilización de OAuth con la API de Twitter

OAuth BibliotecasAdemás de estas bibliotecas OAuth, es posible que desee comprobar hacia

fuera Bibliotecas Twitter más - tienen trabajo backends OAuth.También hay un índice de

bibliotecas proporcionados por el sitio OAuth.

Tabla de contenidos ActionScript / Flash

C / C + +

Clojure

. NET

Erlang

Java

Javascript

Objective-C/Cocoa & iPhone Programación

Perl

PHP

Pitón

Qt

Rubí

Scala

OAuth Herramientas

Page 28: Documentacion Twitter

No hemos intentado todos ellos. Si usted encuentra uno que no funciona, simplemente,

nos dejan saber.

ActionScript / Flash OAuth-as3 - Actionscript 3 biblioteca para implementaciones cliente OAuth, para su

uso en Flash, Flex y AIR.

C / C + + libOAuth - "una colección de funciones de la aplicación de la C OAuth núcleo 1.0 Rev

A API estándar"

Clojure CLJ-OAuth - cliente y el servidor de biblioteca para OAuth Clojure

. NET OAuth-dot-net -. basado en la colección de red para clientes y proveedores, con

muchos ejemplos de uso

DotNetOpenAuth - .net / ASP basado en la colección de clásicos para OAuth y

OpenID.

TwitterVB - una colección de Twitter VB.net apoyar OAuth y xauth.

Erlang erlang-OAuth - basado OAuth biblioteca Erlang. Ver el ejemplo de información de uso.

Java Escribano - una colección extensible OAuth y madura para Java.

OAuth-señal - una biblioteca de Java con el horno en apoyo Android. Algunas áreas de

cumplimiento de especificaciones cuestionable, pero en general muy compatible con la

API de Twitter.

Twitter4J por Yamamoto Yusuke. Una de código abierto, mavenized y Google App

Engine segura Biblioteca de Java para la API de Twitter, publicado bajo la licencia

BSD.

JavascriptJavascript verdad es que no se debe utilizar para OAuth 1.0A con respecto a los sitios web

en los navegadores web. Lo ideal es que sólo vamos a usar Javascript para realizar

operaciones utilizando OAuth del lado del servidor.

OAuth en Javascript

Objective-C/Cocoa & iPhone Programación XAuthTwitterEngine - Una colección de las bibliotecas en Objective-C para trabajar con

XAuth aplicación Twitter por @ aral

OAuthCore - Proporciona una función simple de la firma de peticiones OAuth.

MGTwitterEngine - la colección de Twitter con OAuth y apoyo xauth para Mac OS X y

el desarrollo del iPhone.

MPOAuthConnection - "Con MPOAuthConnection, todo el trabajo de hablar con

proteger los servicios web se toma el cuidado de usted para que usted sólo tiene que

centrarse en la forma que desee utilizar los datos del servicio web remoto ofrece". Mac

OS y el iPhone de apoyo.

Page 29: Documentacion Twitter

Objective-C OAuth - una aplicación amigable Objetivo C-menos.

Perl Net:: OAuth - una colección de Perl para la interfaz OAuth.

PHP OAuth-php - Una biblioteca PHP generalmente fiables OAuth para los proveedores de

servicios ya los consumidores

twitteroauth - @ abraham Twitter biblioteca OAuth para PHP

Pitón OAuth-python-twitter2 - python-twitter Combina y OAuth--twitter python para crear una

evolucionado OAuth Pokemon.

python-oauth2 - (tenedor brosner) mantienen una biblioteca de Python para la

interconexión OAuth

Qt qOAuth - una interfaz Qt para OAuth. Es posible que tenga que hacer una mano de

retención para OAuth 1.0A apoyo.

Rubí OAuth Gema Rubí - una bien probada, fácilmente extensible biblioteca Ruby

adecuados para su uso en los carriles y de otra manera

twitter_oauth - una colección de OAuth para Ruby construido específicamente para su

uso con Twitter.

Scala DataBinder Despacho - una colección de servicios HTTP para OAuth Scala con el

apoyo integrado

OAuth Herramientas OAuth Bailarina - Ruby on Rails una aplicación que se ejecuta en su propio

ordenador. Proporciona información de depuración detallada sobre todos los pasos de

la danza OAuth y le permite hacer la sintaxis de relieve las solicitudes de recursos

contra habilitado REST proveedor de cualquier OAuth

Tutorial Interactivo de las solicitudes de firma - uno de los muchos grandes recursos

OAuth en Hueniverse.

La inclusión en la Bibliotecas OAuth no es un endoso o recomendación de estas

organizaciones en Twitter. Además, dicha inclusión no es la intención de implicar, directa o

indirectamente, que las organizaciones están de acuerdo o tienen alguna afiliación con

Twitter.

Listado de "Entra con Twitter"

Información general"Entra con Twitter" es el modelo de autenticación que permite a los usuarios conectar su

cuenta de Twitter con los servicios de tercera parte-en tan sólo un clic. Utiliza OAuth y

Page 30: Documentacion Twitter

aunque el flujo es muy similar, la dirección de autorización y de flujo de trabajo varía

ligeramente según se describe a continuación.

El flujo normal dicta que las aplicaciones envían señales a la solicitud de OAuth /

autorizar en la aplicación de Twitter de la especificación de OAuth. Para aprovechar la

"Entra con Twitter", las solicitudes deberán enviar fichas solicitud recibida en

el oauth_token parámetro para OAuth / autenticar su lugar.

El OAuth / autenticar método actúan de diversas formas, dependiendo del estado del

usuario y su interacción previa con la aplicación que llama:1. Si el usuario se registra en twitter.com y ya ha aprobado la aplicación de

llamada, el usuario será inmediatamente autenticado y regresó a la dirección de devolución de llamada.

2. Si el usuario no se registra en twitter.com y ya ha aprobado la aplicación de llamada, el usuario se le solicitará que, twitter.com entrada será inmediatamente autenticado y regresó a la dirección de devolución de llamada.

3. Si el usuario se registra en twitter.com y no se ha aprobado ya la aplicación que llama, la autorización OAuth pronto será presentado.Autorizar a los usuarios a continuación, será redirigido a la dirección de devolución de llamada.

4. Si el usuario no se registra en twitter.com y no se ha aprobado ya la aplicación de llamada, el usuario se le pedirá que entrada, twitter.com continuación, se presentará la autorización del sistema antes de redirigir a la dirección URL de devolución de llamada.

Este comportamiento se explica en el siguiente diagrama de flujo:

Page 31: Documentacion Twitter

BotonesTwitter prefiere que su aplicación para que utilice los siguientes botones. Si bien es fácil

rodar sus propios botones o crear enlaces de texto, utilizando estos botones estándar

infundir confianza de los usuarios y estandarizar la experiencia.

Siéntase libre para descargar estas imágenes de acoger en sus propios servidores.Más oscuro Estilo

Encendedor de Estilo

Page 32: Documentacion Twitter

twibs @ también han creado una licencia libre conjunto de botones que usted puede tener

gusto de usar en su sitio.

OAuth FAQ

¿Qué es OAuth?

OAuth es un protocolo de autenticación que permite a los usuarios para aprobar la solicitud

para actuar en su nombre sin compartir su contraseña. Más información se puede

encontrar en oauth.net o en la excelente Guía del principiante hasta OAuth de Hueniverse.¿Dónde puedo crear una aplicación?

Puede crear nuevas aplicaciones en el sitio para desarrolladores de Twitter

en http://dev.twitter.com/apps/new.Cuando vas a apagar autenticación básica?

Hemos anunciado en diciembre de 2009, la desaprobación de autenticación básica. Su

fecha de salida de la plataforma está previsto para junio 2010. Anunciamos a finales de

junio de 2010 que hemos aplazado hasta este 16 de agosto 2010.¿Puede mi solicitud seguir utilizando autenticación básica?

Puede seguir utilizando autenticación básica hasta el desvío hacia la fecha, pero le

recomendamos pasar a OAuth ahora. Hemos aumentado los límites de frecuencia para el

tráfico de OAuth api.twitter.com extremos a 350 solicitudes por hora, más del doble del

actual límite de velocidad básica Auth.¿Cómo puedo convertir mi solicitud de autenticación básica para OAuth?

La conversión depende en gran medida el lenguaje de programación y las bibliotecas que

utiliza. Ver La transición de la autenticación básica para OAuth ayuda.

Técnico¿Cuánto tiempo dura un testigo de acceso por última vez?

Actualmente, no expirará tokens de acceso. Su token de acceso no será válida si el

usuario rechaza explícitamente la aplicación desde su configuración o si un administrador

de Twitter suspende su aplicación. Si su aplicación está suspendida habrá una nota en su

página de la solicitud diciendo que ha sido suspendido.La página de registro de solicitud es sobre lectura y escritura. ¿Qué es una escritura?

Muchos usuarios confían una aplicación para leer su información pero no necesariamente

cambiar su nombre o correo nuevos estados.Actualización de la información a través de la

API de Twitter - ya sea el nombre, la ubicación o la adición de un nuevo estado - requiere y

HTTP POST. Nos quedamos con la misma restricción en la aplicación de la

presente. Cualquier método que requiere un API HTTP POST se considera un método de

escritura y lectura y requiere acceso de escritura.

Page 33: Documentacion Twitter

API REST & General Recientemente Documentación actualizada

estados / seguidores

Devuelve los seguidores del usuario que se autentica, cada uno con la situación actual

en línea. Están ordenadas por el orden en que hayan seguido el usuario, 100 a la

vez. (Tenga en cuenta que el conjunto de resultados no está garantizada al 100 cada

vez que los usuarios suspendidos se eliminará .)...

Actualizado el 19 de julio 2010 por themattharris

estados / amigos

Devuelve los amigos de un usuario, cada uno con la situación actual en línea. Están

ordenadas por el orden en que el usuario los siguió, más recientemente, seguido

primero, 100 a la vez. (Tenga en cuenta que el conjunto de resultados no está

garantizada al 100 cada vez que los usuarios suspendidos se eliminará .)...

Actualizado el 19 de julio 2010 por themattharris

estados / retweets_of_me

Devuelve el 20 tweets más recientes del usuario autenticado que se han retweeted por

otros.

Actualizado el 16 de julio 2010 por themattharris

estados / retweeted_to_me

Devuelve el 20 retweets más reciente publicado por los usuarios el usuario que se

autentica seguir.

Actualizado el 16 de julio 2010 por themattharris

estados / retweeted_by_me

Devuelve el 20 retweets más reciente publicado por el usuario que se autentica.

Actualizado el 16 de julio 2010 por themattharris

estados / menciona

Devuelve el más reciente menciona 20 (estado que contiene @ nombre de usuario)

para el usuario que se autentica ....

Actualizado el 16 de julio 2010 por themattharris

estados / friends_timeline

Devuelve el reciente 20 estados de la mayoría escritos por el usuario que se autentica y

el usuario que siguen. Esta es la misma línea de tiempo visto por un usuario cuando se

inicia sesión a twitter.com....

Actualizado el 16 de julio 2010 por themattharris

estados / user_timeline

Devuelve el reciente 20 estados de la mayoría escritos por el usuario que se

autentica. También es posible solicitar la línea de tiempo del usuario utilizando la

otra screen_name o user_id parámetro. El plazo de otros usuarios sólo será visible si

no son protegidas, o si el usuario se autentica siga petición fue aceptada por el usuario

protegidas ....

Actualizado el 16 de julio 2010 por themattharris

estados / home_timeline

Devuelve el reciente 20 estados más, incluyendo retweets si existen, escritos por el

usuario que se autentica y el usuario que siguen. Esta es la misma línea de tiempo

visto por un usuario cuando se inicia sesión a twitter.com....

Actualizado el 16 de julio 2010 por themattharris

Page 34: Documentacion Twitter

estados / public_timeline

Devuelve el 20 estados más recientes, incluyendo retweets si existen, de los usuarios

no protegidos ....

Actualizado el 15 de julio 2010 por themattharris

Introducción a @ twitterapi

http://dev.twitter.com/pages/intro-to-twitterapi

Cosas que cada desarrollador debería saber

0) El contenido de las preguntas más frecuentesSi usted está comenzando con la API, para familiarizarse con las preguntas más

frecuentes y saber que existe.

1) En realidad hay tres APIsLa API de Twitter se compone actualmente de dos APIs REST discreta y una API de

streaming. La mayoría de los desarrolladores de aplicaciones mezclar y hacer coincidir las

API para producir su aplicación. La separación de los demás y las API de búsqueda es

menos que ideal y se debe exclusivamente a la historia es en nuestra línea para mejorar la

API de Twitter mediante la combinación de la Búsqueda y piezas resto como los ciclos de

desarrollo lo permitan. La API general parte de la Introducción serie Cómo explica la

historia. El API proporciona-Streaming volumen de acceso de alta latencia baja para

Tweets.

2) Usted no puede hacer llamadas ilimitadas, siga las solicitudes, actualizaciones o directa mensaje

uso de la API es la tasa limitada. Además, se imponen límites sobre el número de

solicitudes de seguimiento, las actualizaciones y los mensajes directos que puedes hacer

en un solo día. Contamos con una cartilla que usted debe leer para aprender más.

3) El API es completamente basado en HTTPMétodos para recuperar datos de el Twitter API requieren un GET petición. Los métodos

que presenten, cambiar o destruir los datos requieren unPOST. A BORRAR solicitud se

admitan también para los métodos que destruyen datos. Métodos de API que requieren

una particular método HTTP devolverá un error si usted no hace su pedido con el método

correcto. HTTP Códigos de respuesta son significativos.

4) El API es un recurso RESTCon la excepción de la API de Streaming, el Twitter API intentos para ajustarse a los

principios de diseño de Representational State Transfer(REST). Simplemente cambia la

extensión de formato de una solicitud para obtener resultados en el formato de su

elección. La documentaciónseñala qué formatos están disponibles para cada método. La

API actualmente soporta los formatos de los siguientes datos: XML, JSON, y

el RSSy Atom formatos de sindicación, con algunos métodos aceptando solamente un

subconjunto de estos formatos.

5) Los parámetros tienen ciertas expectativas

Page 35: Documentacion Twitter

Algunos API métodos tomar o necesarios parámetros opcionales. Dos cosas a tener en

cuenta al realizar las solicitudes con los parámetros:1.Los valores de parámetros deben ser convertidos a UTF-8 y URL   codificada . 2.La página de parámetros comienza a la 1, no 0.

Hay dos parámetros especiales de la API de Twitter:  de devolución de llamada: Se usa sólo cuando se solicite el formato JSON

respuestas, este parámetro se ajusta la respuesta en un método de devolución de llamada de su elección. Por ejemplo, añadiendo y de devolución de llamada =

myFancyFunction a su solicitud dará lugar a un cuerpo de la respuesta de: (...)

myFancyFunction.  devoluciones de llamada sólo puede contener caracteres

alfanuméricos y guiones, y cualquier caracteres no válidos pueden ser retirados. suppress_response_codes: Si este parámetro está presente, todas las respuestas

serán devueltos con un 200 OK código de estado - incluso los errores. Este parámetro

existe para dar cabida a aplicaciones Flash y JavaScript que se ejecuta en los

navegadores que no interceptar todas las respuestas-200. Si se utiliza, es entonces el

trabajo del cliente para determinar los estados de error al analizar el cuerpo de la

respuesta.Utilizar con precaución, como los mensajes de error pueden variar.

Donde se indique, algunos métodos de la API se obtendrán resultados diferentes sobre la

base de los encabezados HTTP enviados por el cliente. Si el mismo comportamiento

puede ser controlado tanto por un parámetro y una cabecera HTTP, el parámetro tendrá

prioridad.

límites 6) Existen paginaciónLimite el API REST

Los clientes pueden acceder a un máximo teórico de 3.200 estados a través de la página y contar con parámetros para la user_timeline REST métodos de la

API. Otros métodos de control temporal de un máximo teórico de 800 estados. Las

solicitudes de más que el límite se traducirá en una respuesta con un código de estado de

200 y un resultado vacío en el formato solicitado. Twitter aún mantiene una base de datos

de todos los tweets enviados por un usuario. Sin embargo, para asegurar el rendimiento

del sitio, este límite temporal artificial en su lugar.API de búsqueda de Límite

Los clientes pueden solicitar hasta 1.500 estados a través de la página y rpp parámetros

para la búsqueda de método. La respuesta a una solicitud que exceda este límite será un

código de estado de 200 y un resultado vacío en el formato solicitado. Este límite artificial

para garantizar el desempeño del sistema de búsqueda. También limitar el tamaño del

índice de búsqueda mediante la colocación de un límite de fecha de las actualizaciones

que le permiten realizar la búsqueda. Este límite es actualmente alrededor de 1,5

semanas, pero es dinámico y está sujeto a disminuir el número de tweets por día sigue

creciendo.

7) Codificación afecta a contar de estado de carácterLa API de Twitter soporta UTF-8 de codificación. Tenga en cuenta que entre paréntesis

angulares ("<" y ">") son de entidad-codificados para evitar ataques Cross-Site Scripting

para la web embebido en los consumidores de JSON de salida de la API. El resultado de

entidades codificadasno cuentan para el límite de 140 caracteres. Al solicitar XML, la

respuesta es codificación UTF-8. Símbolos y personajes fuera de la gama estándar ASCII

pueden ser traducidas a entidades HTML.

Page 36: Documentacion Twitter

8) Una línea de comandos es todo lo que necesita para utilizar la API de Twitter 

Si su sistema tiene rizos (y debe!), ya tienes una gran manera de hurgar el Twitter API. He

aquí algunos ejemplos:

Accede a la linea publica en formato RSS, no autenticados: curl http://api.twitter.com/1/statuses/public_timeline

.rss

Obtener información actualizada de los usuarios de seguir en XML, y cuya autenticidad: curl-u

usuario

:contraseñahttp://api.twitter.com/1/statuses/friends_timeline.xml

Ver sólo los encabezados de que la última solicitud: curl - la cabeza u-nombre

de

usuari

o:contraseñahttp://api.twitter.com/1/statuses/friends_timeline.xm

l

Publicar un estado de actualización y obtener el estado que resulta de nuevo como JSON: curl-u usuario:contraseña -estado de d = "su mensaje

aquí" http://api.twitter.com/1/statuses/update.json

Aprenda más sobre cURL y la API de aquí.

9) Hay Twitter bibliotecas API para casi cualquier idioma.La Comunidad ha creado numerosas bibliotecas de la API de Twitter y está dispuesto a

compartir.

Twitter API FAQ

Conceptos básicos¿Qué es un API?

La sigla "API"significa" Application Programming Interface ". Una API es un método

definido para un programa para realizar una tarea, por lo general recuperar o modificar

datos. En el caso de Twitter, nos proporciona una API método para casi todas las

características que puedes ver en nuestra página web. Los programadores usan la API de

Twitter para hacer que las aplicaciones, sitios web, los widgets, y otros proyectos que

interactuar con Twitter. Programas de hablar a la API de Twitter más de HTTP, el mismo

protocolo que el navegador utiliza para visitar e interactuar con páginas web.

¿Cómo se utiliza la API de Twitter?Si desea que la aplicación para hacer el tipo de cosas que un usuario de Twitter puede

hacer, echa un vistazo a la documentación de la API REST. Si desea buscar

actualizaciones de Twitter pública mediante programación, consulte la documentación de

la API de búsqueda. No es necesario escribir todo el código para hablar con el API de

Twitter desde cero, como los desarrolladores han compartido buena fuente de bibliotecas

de código abierto que se encarguen de eso. Si quieres ver ejemplos de completo,

trabajando proyectos Twitter API, hay un montón de ejemplos de código abierto para mirar

a través.

Page 37: Documentacion Twitter

¿Cómo puedo contar en 140 caracteres?La definición de un "carácter", y luego contar a cabo 140 de ellos es clave para cualquier

aplicación de Twitter. También puede ser difícil si la sutileza está utilizando caracteres que

están más allá ASCII y UTF-8. Hemos preparado un breve panorama sobre cómo contar

los caracterescorrectamente si necesita ayuda.

Necesito algo!¿Cómo puedo obtener "a partir de [MyApp]" añadido a las actualizaciones enviadas desde mi aplicación API?

Ahora los desarrolladores recomiendan el uso OAuth para realizar la autenticación con la

API. Cuando las aplicaciones utilizan OAuth, Twitter automáticamente conoce el origen de

las actualizaciones de estado. Por consiguiente, podemos añadir atribución de la

procedencia (de "[MyApp]") para tweets. Si desea tweets de su solicitud para recibir un

parámetro de fuente, por favor registrar una aplicación y aplicar la autenticación

OAuth. Manera automática, incluyen la aplicación como la fuente para cualquier tweets

enviados desde su aplicación.

Originalmente permitían a las aplicaciones para crear una fuente de parámetros para el

uso no OAuth, pero que se ha interrumpido.Aplicaciones parámetros fuente pre-OAuth

seguirá activa, pero las nuevas inscripciones ya no son aceptadas.

Sigo golpeando el límite de velocidad. ¿Cómo puedo obtener más solicitudes por hora?

Sólo tienes que rellenar este formulario a mano otros! Tenga en cuenta que debe tener

una cuenta de Twitter y debe ser firmado en como la cuenta que desea que la tasa de

los límites planteados por. Por favor, tenga en cuenta que sólo los desarrolladores para

aprobar la lista blanca.

Puede tomar hasta 72 horas para que podamos volver a usted, pero tratamos de

responder a las peticiones lo más rápido posible restricción de las vacaciones y los

desastres. Una vez que esté en la lista blanca que será capaz de llevar hasta 20.000

solicitudes por hora. Úsalos con inteligencia!

¿Cómo puedo recuperar una cuenta de Twitter inactivos para mi proyecto o una aplicación?

Tenemos un artículos de ayuda primaria que habla acerca de la inactividad en el nombre

de usuariohttp://help.twitter.com/forums/26257/entries/15362-inactive-usernames. En

general, no podemos transferir nombres de usuario para uso personal en este momento. Si

usted cree una cuenta de Twitter puede ser en cuclillas en su marca registrada y violación

de Twitter Condiciones del servicio, por favor envíe un ticket

en http://help.twitter.com/requests/new sobre "Marcas / Marca en cuclillas".

¿Cómo puedo informar de los errores y pedir las características?Puedes ver la lista de ediciones anteriores aquí. Por favor, revise para asegurarse de que

su problema no ha sido descubierto. Estrella de un título existente a votar por él, o añadir

un ejemplo de un problema si lo describe su error. O bien, informar de un problema nuevo

si es necesario.

¿Cómo puedo obtener mi aplicación en el cuadro de promoción de la barra lateral?

Las aplicaciones en la labor de promoción cuadro de la barra lateral, como escoger el

editor en la librería. Ellos fueron elegidos porque hacer algo muy bien. No existe un

Page 38: Documentacion Twitter

formulario que usted puede llenar para que su solicitud sea considerada. Recibimos

nuestras sugerencias de los usuarios la adopción de una aplicación en particular. Así que

desarrollar algo grande y cuando nos enteramos de ello, usted encontrará su nombre en

luces.

Mi aplicación no funcionará!¿Qué estoy haciendo mal?

Es muy probable que usted no, sino más bien de un error en una biblioteca de HTTP o

Twitter API de la biblioteca que está utilizando. Pruebe su petición de API con un buen

conocido, como herramienta fiable rizo. Nueve de cada diez veces, trabaja con rizos. Si

eso no resuelve el problema, utilizar un proxy HTTP, como Charles para saber lo que está

pasando entre la aplicación y los servidores de Twitter. Es imprescindible que provean

plena petición HTTP y la respuesta para que su compañero desarrolladores de Twitter

para ayudarte cuando la presentación errores y discutir la API.

¿Es la API de Twitter abajo?No es probable: Twitter no ha tenido más de un par de minutos de tiempo de inactividad en

cuando. Las solicitudes pueden quedarse de vez en cuando, pero es muy probable que no

estamos abajo. Usted siempre puede comprobar el estado de Twitter registro para ver qué

está pasando con el sitio. Este registro se encuentra en un servicio totalmente diferentes

de Twitter y en un centro de datos diferentes, por lo que no debe estar sujeta a ningún

tiempo de inactividad Twitter podría incurrir.

¿Mi IP o en la lista negra?Si ha realizado más de su asignación de las solicitudes (que es hasta 20.000 por hora para

los PI y las cuentas de la lista blanca), nuestro equipo de operaciones puede muy bien

haber bloqueado su IP o rango de direcciones IP. Ofrecemos a nuestros APIs para libre y

con ningunagarantía o condiciones del servicio. Eso significa que puede adoptar medidas

para prohibir o bloquear cualquier cuenta, IP, o rango de IPs que pueden estar haciéndole

daño a nuestra capacidad de ofrecer Twitter en una manera oportuna y confiable. Si usted

piensa que ha sido prohibida, por favor envíenos un correo electrónico y nosotros lo

solucionaremos.

¿Por qué mis archivos de la imagen siempre fallan?Los métodos de actualización de imágenes requieren que el formulario de datos de varias

partes. No aceptan una dirección URL a una imagen ni aceptar los bytes de la imagen en

bruto. Por el contrario, requieren los datos que se entregarán en forma de una carga de

archivo presentado tal como se define en RFC1867. El tipo de atributo contenido del

campo de la imagen está marcada para el tipo de imagen válida. Si está usando PHP /

CURL hay un error conocido que desde entonces ha sido corregido en la versión CVS de

PHP. La mayoría de las instalaciones aún no están utilizando esta versión y por lo tanto un

error durante la carga de imágenes.

Patrones de diseño¿Cómo debe ser mi bot seguir a los usuarios que le siguen o inspeccionar los mensajes directos?

Page 39: Documentacion Twitter

De forma predeterminada, Twitter envía un e-mail la primera vez que un usuario te sigue o

le envía un mensaje directo. Para deleite de su robot de la capacidad, hemos añadido los

siguientes encabezados de los correos electrónicos:

X-TwitterEmailType - será "is_following 'o direct_message"

X-TwitterCreatedAt - ex: Jue Ago 07 15:17:15 -0700 2008

X-TwitterSenderScreenName - por ejemplo: 'bob'

X-TwitterSenderName - por ejemplo: "Bob Smith '

X-TwitterSenderID - ex: 12345

X-TwitterRecipientScreenName - por ejemplo: 'juan'

X-TwitterRecipientName - por ejemplo: 'John Doe'

X-TwitterRecipientID - por ejemplo: 67890

X-TwitterDirectMessageID - por ejemplo: 2346346

¿Cómo puedo evitar que se ejecute en el límite de velocidad?1. El almacenamiento en caché . Le recomendamos que las respuestas de la API

de caché en su aplicación o en su sitio si usted espera un volumen alto uso. Por ejemplo, no trate de llamar a la API de Twitter en cada carga de página de su popular sitio web enormemente. En su lugar, llame a nuestra API de una vez por minuto y guardar la respuesta por tu parte, mostrando su versión en caché en su sitio.

2. La limitación de tasas  por el usuario activo. Si su sitio hace un seguimiento de muchos usuarios de Twitter (por ejemplo, ir a buscar su estado actual o estadísticas sobre su uso de Twitter), por favor considere sólo solicita datos a los usuarios que hayan accedido a su sitio.

Estas son sólo algunas de las estrategias ejemplo. Estamos encantados de trabajar con

usted para encontrar soluciones que mantengan su solicitud y nuestra API funcionando sin

problemas. Sólo disparar [email protected] un correo electrónico.

¿Cómo puedo obtener todas las respuestas a una situación en particular?

Por el momento, no hay una buena manera de hacer esto. Hemos escuchado las

solicitudes, sin embargo, y vamos a proporcionar una solución para que en poco tiempo.

¿Dónde está La API de ir?¿Cómo puedo seguir el ritmo de los cambios en la API de Twitter?

Hay una serie de grandes maneras de seguir los cambios que hacemos a la API de

Twitter:

Siga @ twitterapi en Twitter.

Leer el bajo volumen de la API de Twitter Anuncios Google grupo.

Participa en la conversación sobre el Twitter hablar de desarrollo del grupo de Google.

Cuando se Twitter apoyo OAuth?A partir de marzo de 2009, OAuth se ha trasladado a una beta pública. La aplicación es

estable y puede ser usado para los sitios públicos. Es todavía en fase beta por lo que

establece nuestra implementación de la característica todavía no está completo, le falta

pulir UX, y todavía está sujeto a posibles cambios. Una vez que todos los errores son

subsanadas y es compatible con una mejor experiencia de usuario para los casos de uso

de escritorio y móviles, OAuth se convertirá en el sistema de autenticación compatibles

con Twitter, y autenticación básica HTTP probablemente será obsoleto después de un

largo período de gracia.

Page 40: Documentacion Twitter

¿Puedo tener la manguera de bomberos u otros elevados Streaming acceso a la API?

A principios de 2010 vamos a ofrecer detalles a nuestro anuncio de la disponibilidad de

datos en la conferencia de diciembre 2009 LeWeb.Mientras tanto, algunos un mayor

acceso está disponible en una por caso, caso por correo electrónico a su caso el uso de

aplicaciones y un fondo organización breve [email protected]. Casi todos los casos de uso

pueden estar satisfechos con un cierto uso creativo de una combinación de los flujos de

público en la API de streaming.

¿Vas a hacer que el resto de la API y el API de búsqueda de trabajo de la misma?

Yup! Ese es uno de nuestros principales objetivos para 2010.

Vista general de la API

La API de TwitterLa API de Twitter se compone de tres partes: dos APIs REST y una API de streaming. Las

dos APIs REST distintas se deben por completo a la historia. Summize, Inc. fue

originalmente una compañía independiente que proporciona capacidad de búsqueda para

los datos de Twitter.Summize más tarde fue adquirido y rebautizado como Twitter

Search. Rebranding el sitio era fácil, la plena integración de Twitter y su API de búsqueda

en el código a Twitter es más difícil. Es en nuestra línea de unificar las API, pero hasta que

lo permitan los recursos de la API REST API de búsqueda y se mantendrá como entidades

separadas. La API en flujo continuo es distinta de la API REST como dos Streaming

soporta conexiones de larga duración en una arquitectura diferente.

Los métodos de la API REST Twitter permite a los desarrolladores acceder a datos

básicos de Twitter. Esto incluye los plazos de actualización, los datos de estado, e

información al usuario. La API de los métodos de búsqueda proporcionan a los

desarrolladores métodos para interactuar con Twitter de búsqueda y los datos de

tendencias. La preocupación por los desarrolladores de esta separación es determinado

los efectos sobre la limitación de velocidad y formato de salida. El API proporciona cerca

de Streaming-volumen de acceso en tiempo real de alta tweets en la muestra y se filtra

formulario.

Para obtener información sobre los métodos y datos disponibles a través de la API,

consulte la documentación técnica de la API de Twitter.

Nos divulgar públicamente los defectos actuales y mejoras. defectos actuales y las

prioridades de mejora se pueden ver en nuestra lista de temas. Objetivos a largo plazo se

registran en el documento hoja de ruta.

El API se actualiza periódicamente con nuevas características. De vez en cuando

desprecian características. Todos estos cambios son comunicados en los siguientes

lugares:

@ Twitterapi  en Twitter.

El bajo volumen de la API de Twitter Anuncios Google grupo.

La conversación en el Twitter hablar de desarrollo del grupo de Google.

Page 41: Documentacion Twitter

Soporte API

Documentación de la APILa documentación oficial de Twitter que solía ser alojados en apiwiki.twitter.com pero

hemos movido desde entonces el contenido de laDocumentación de la API en este sitio. Si

no puede encontrar lo que busca en este sitio significa que no hemos sido capaces de

transferencia de la wiki todavía. Si el contenido existe en el apiwiki y este sitio debe usar

este contenido sitios.

Cuestiones ListaHacemos nuestra lista de temas de colaboración, porque los desarrolladores que utilizan el

ejercicio de la API y el código de encontrar defectos.Si usted tiene un problema por favor

busque la lista de cuestiones para encontrar que ya son conscientes del defecto. Tenga

en cuenta que los valores predeterminados de búsqueda a "Cuestiones pendientes", así

que asegúrese de seleccionar "Todos los números" antes de ejecutar la consulta. Si

verifica un informe de problema no existe, por favor, añadir en consecuencia con el mayor

detalle posible.

Twitter Grupo de Desarrollohttp://groups.google.com/group/twitter-development-talk es el oficial de desarrollador lista

de Twitter. Twitter periódicamente a los empleados del timbre para responder a las

preguntas y preocupaciones desarrollador. Si se tiene un problema o sugerencia para

otros desarrolladores de API, puesto que allí, pero por favor busque un debate abierto

antes de publicar un nuevo hilo.

Correo electrónicoLa última línea de defensa. Si usted ha agotado la lista anterior de los recursos y se siente

seguro de que sus necesidades no pueden ser atendidas allí, enviar un email a

[email protected].

Mejores prácticas de seguridad

IntroducciónEl éxito de la aplicación Twitter es probable conseguir un poco de atención. La mayor parte

de que la atención será bueno: Los usuarios de cantar sus alabanzas, otros

desarrolladores felicita sus chuletas de programación. Parte de esa atención, sin embargo,

podría ser negativo.Como Twitter ha aumentado su popularidad, el ecosistema de Twitter

se ha convertido en un objetivo más visible para los hackers maliciosos.Algunos están

fuera para distribuir spam y malware, mientras que otros sólo se puede estar propagando

el caos para la diversión. Cualesquiera que sean sus motivos, su aplicación puede ser un

objetivo.

Esta página está diseñada para que usted tenga en el camino hacia una mayor seguridad

en su aplicación. No es la última palabra, ni mucho menos. Si hay algo que le gustaría ver

agregado a ella, por favor háganoslo saber. Si usted ha descubierto un problema de

seguridad que afecta directamente a Twitter, por favor escriba a [email protected]. Si

desea GPG cifrar su correo electrónico, por favor utilice nuestro clave pública. Si su

Page 42: Documentacion Twitter

problema de seguridad es legítimo, podemos darle la atribución para el descubrimiento de

nuestra Seguridad Contribuyentespágina bajo petición.1.Introducción 2.Amenazas

i. General a. Contraseña de retención b. La validación de entradas c. Comunicación sin cifrar (sin SSL) d. Expuesto información de depuración e. Prueba Incorrecta f. No dejar que la gente Ayuda g. La Ley

ii. Seguridad en aplicaciones Web a. Sin filtro de entrada, sin escape de salida b. Cross-Site Scripting (XSS) c. Inyección de SQL d. Solicitud de Cross-Site Falsificación (CSRF) e. La falta de limitación de velocidad f. La falta de información sobre las amenazas

iii. Seguridad de aplicaciones de escritorio a. Almacenamiento de credenciales sin cifrar

3.Recursos de Seguridad a. General b. Seguridad en aplicaciones Web c. Seguridad de aplicaciones de escritorio

AmenazasGeneral

Las amenazas a continuación se aplicarán sin importar su plataforma.Contraseña de retención

En resumen, no conservan las contraseñas. el apoyo de Twitter de la autenticación básica

HTTP (la forma estándar para autenticar a través de la web con un nombre de usuario y

contraseña) será considerado obsoleto. Por favor, use OAuth.

Si usted es conservar contraseñas, por favor cifrar. En Twitter, usamos bcrypt-rubí, pero

hay muchas otras maneras de almacenar las contraseñas cifradas. Pero, no. No lo

hagas. No guarde contraseñas. Sólo tienda OAuth fichas. Por favor.La validación de entradas

No asuma que los usuarios le proporcionará los datos válidos, confiables. Desinfecte todos

los datos, la comprobación de longitud de las cadenas sano, tipos de archivo válidos, etc

Twitter intenta desinfectar los datos publicados en nuestro API, pero un poco de ayuda de

cliente recorre un largo camino. Lista blanca de los tipos de entrada que es aceptable para

su aplicación y desechar todo lo que no está en la lista blanca.Comunicación sin cifrar (sin SSL)

Twitter ofrece todos los métodos API REST a través de SSL. Cada vez que el código

podría estar operando en una red insegura (es decir, si está desarrollando una aplicación

de cliente), por favor haga uso de SSL para todas las solicitudes autenticadas o

sensible. Por ejemplo, la publicación de un estado, solicitando los últimos mensajes

directos, y la actualización de todos los atributos de perfil se debe realizar a través de SSL

en un cliente de Twitter. Es seguro y sugiere usar SSL en relación con OAuth.

Comunicación del Servicio-A-servicio no pueden beneficiarse de SSL si confía en su

proveedor de alojamiento (o eres tu propio proveedor de alojamiento).

Page 43: Documentacion Twitter

Expuesto información de depuración

Asegúrese de que usted no es exponer información sensible a través de pantallas de

depuración / logs. Algunos marcos Web facilitan el acceso a la información de depuración

si su aplicación no está correctamente configurado. Para los desarrolladores de escritorio y

móviles, es muy fácil enviar accidentalmente una generación con la depuración de

banderas o símbolos habilitado. Generar los controles de estas configuraciones en su

despliegue y proceso de generación.Prueba Incorrecta

Asegúrese de que sus pruebas (usted tiene pruebas, ¿no?) no sólo comprobar que usted

puede hacer lo que debe ser capaz de hacer, pero que los chicos malos no pueden hacer

lo que no debería ser capaz de hacer. Ponte en una mentalidad atacante y el látigo por

algunas pruebas del mal.No dejar que la gente Ayuda

¿Ha creado [email protected]? ¿Los mensajes de correo electrónico a la

derecha en el teléfono? Que sea fácil para las personas en contacto con usted acerca de

los posibles problemas de seguridad con la aplicación. Si alguien se informe de una falla

de seguridad para usted, ser amable con ellos, porque acabo de hacer un gran

favor. Gracias por su tiempo y solucionar el problema de inmediato. Es bastante común

para los investigadores de seguridad para escribir acerca de las vulnerabilidades que

hemos descubierto una vez que el agujero se ha cerrado, por lo que no se preocupe si su

aplicación termina en un blog o trabajo de investigación. La seguridad es duro, y nadie es

perfecto.Mientras usted esté preparando los temas que se informa a usted, usted está

haciendo bien.

Considere la posibilidad de contratar a profesionales de la seguridad de hacer una

auditoría y / o prueba de penetración. No se puede depender únicamente de la bondad de

los extraños, porque todas las vulnerabilidades que alguien tuvo la gentileza de informar a

usted, hay diez más que los hackers maliciosos han encontrado. Una empresa de

seguridad buena voluntad cavar hondo para descubrir asuntos. Puedes buscar las

empresas y los consultores individuales que hacen más que ejecutar una pocas

herramientas automatizadas.La Ley

Si su solicitud es (va a ser) el manejo del dinero, usted puede ser requerido por la ley a

que se adhieran a las prácticas de seguridad de los reglamentos. Averigüe qué es

aplicable a usted y asegúrese de que está con el código.Seguridad en aplicaciones Web

Sin filtro de entrada, sin escape de salida

Un método fácil de recordar enfoque de la validación de la entrada es FIEO: El filtro de

entrada, salida de escape. Filtro nada de fuera de su aplicación, incluyendo los datos de la

API de Twitter, información de la cookie, entrada de un formulario suministrado por el

usuario, parámetros de URL, los datos de bases de datos, etc todas las salidas de escape

que son enviados por su aplicación, incluyendo SQL enviada al servidor de base de datos,

HTML a enviar a los navegadores de los usuarios, JSON / salida XML enviados a otras

redes, y los comandos enviados a los programas de shell.Cross-Site Scripting (XSS)

XSS ataques son, por mayoría de las medidas, la forma más común de problemas de

seguridad en la web. En pocas palabras, si un atacante puede obtener su propio código

JavaScript en su aplicación, que pueden hacer cosas malas. En cualquier lugar donde

Page 44: Documentacion Twitter

guardar y que no se confía de pantalla, los datos suministrados usuario necesita ser

comprobada, desinfectarse y escapó HTML. Obtener este derecho es difícil, porque los

hackers han muchas maneras diferentes a la tierra ataques XSS. Su lenguaje o marco de

desarrollo web probablemente tiene una, bien probada mecanismo popular para la defensa

contra-site scripting cruz, por favor haga uso de ella.

En general: el HTML no es necesario de alguna forma de cara del usuario, filtrar, por

ejemplo, no hay razón para que algo que no sea enteros al almacenar un número de

teléfono. Si el HTML es necesario, utilice una buena lista blanca del filtro

conocidas. HTMLPurifier para PHP es una solución de este tipo. contextos diferentes

pueden requerir enfoques diferentes de filtrado. Ver la OWASP XSS Prevención Hoja de

trucos para más información sobre el filtrado.Inyección de SQL

Si la aplicación hace uso de una base de datos, necesita estar al tanto de inyección de

código SQL. Una vez más, en cualquier lugar que acepte de entrada es un blanco

potencial para un atacante para salir de su campo de entrada y en su base de datos. Use

las bibliotecas de base de datos que protegen contra la inyección de código SQL de

manera sistemática. Si salir de ese enfoque personalizado y escribir SQL, escribir pruebas

agresivas para asegurarse de que no se está exponiendo a esta forma de ataque.

Los dos enfoques principales para la defensa frente a la inyección SQL se escapan antes

de construir la instrucción SQL y el uso de parámetros de entrada para crear

declaraciones. Este último se recomienda, ya que es menos propenso a errores del

programador.Solicitud de Cross-Site Falsificación (CSRF)

¿Estás seguro de que las peticiones para su aplicación viene de su

aplicación? CSRF ataques aprovechan esta falta de conocimiento al obligar a los usuarios

registrados de su sitio en silencio para abrir direcciones URL que realizar acciones. En el

caso de una aplicación de Twitter, esto podría significar que los atacantes están utilizando

su aplicación para obligar a los usuarios para publicar tweets no deseado o spam siga

cuentas. Usted puede aprender más sobre este tipo de ataque en PHP experto en

seguridad Chris Shiflett blog.

La manera más exhaustiva para hacer frente a CSRF es incluir una ficha al azar en todas

las formas que se almacena en algún lugar de confianza, si un formulario no tiene el token

derecha, un error. marcos modernos web tienen formas sistemáticas de manipulación de

este, e incluso podría estar haciéndolo de forma predeterminada si se tiene suerte. Un

simple paso preventivo (pero de ninguna manera el único paso que debe tomar) es hacer

que toda acción que crear, modificar o destruir datos requieren una solicitud POST.La falta de limitación de velocidad

CAPTCHAs en su caso para frenar los spammers y los atacantes potenciales.La falta de información sobre las amenazas

Si crees que hay un problema con la aplicación web, ¿cómo saber con más seguridad? Ha

excepciones críticas y los errores enviado por correo electrónico y mantener una buena

registros. Es posible que desee para armar un cuadro de mando de las estadísticas crítica

para que pueda ver de un vistazo si algo va mal (o se encuentren a la derecha). Seguridad de aplicaciones de escritorio

Podríamos utilizar las sugerencias de los desarrolladores de escritorio sobre los problemas

de seguridad que he encontrado. Los desarrolladores que trabajan con el suficiente

Page 45: Documentacion Twitter

lenguajes de alto nivel no se debe hacer frente a desbordamientos de búfer y los

problemas de seguridad habituales. ¿Qué has defendido?Almacenamiento de credenciales sin cifrar

Como se ha mencionado, para optimizar la seguridad que usted debe utilizar OAuth. Pero

una vez que haya una ficha con la cual hacer peticiones en nombre de un usuario, ¿dónde

lo pones? Idealmente, en un almacén cifrado administrado por el sistema operativo. En

Mac OS X, este sería el llavero. En el entorno de escritorio GNOME, está el llavero. En el

entorno de escritorio KDE, hay KWallet.

Recursos de SeguridadLos siguientes enlaces son grandes maneras de aprender más acerca de la seguridad. La

seguridad es un tema profundo, pero no se siente como usted tiene que aprender todo

sobre él antes de tomar medidas preventivas para bloquear la aplicación. Un poco de

seguridad de miras va un largo camino.General

Purdue CERIAS  - Centro de Educación e Investigación en Aseguramiento de la

Información y de Seguridad

US-CERT  - actuales amenazas identificadas para varias plataformas y aplicaciones

CERT Información para desarrolladores  - prácticas de codificación seguraSeguridad en aplicaciones Web

OWASP Top Ten de las amenazas  - la lista definitiva de las amenazas más

apremiantes que enfrenta los desarrolladores de aplicaciones web.

La detección de intrusión  - es posible que desee ejecutar un Sistema de Detección de

Intrusos (IDS) para encontrar posibles atacantes.

PHP herramientas para el filtrado y la validación  - generosamente proporcionado por el

veterano desarrollador de Twitter @ funkatron.Seguridad de aplicaciones de escritorio

Apple Developer Connection - Seguridad

Apple sujete la guía de codificación

Seguridad MSDN Developer Center

Programación Segura para Linux y Unix HOWTO

Limitación de velocidad

Tabla de contenidos Califica API REST Limitar

Saber si está limitada tasa de

Lista blanca

API de búsqueda de limitación de velocidad

Consejos para evitar ser Califica Limitada

Listas negras

Streaming API

La API de Twitter sólo permite a los clientes hacer un número limitado de llamadas en una

hora determinada. Esta política afecta a la API de diferentes maneras.

Califica API REST Limitar

Page 46: Documentacion Twitter

El límite de tasa de morosidad de las llamadas a la API REST varía en función del método

de autorización se está utilizando.

llamadas anónimas se basan en la IP de la máquina y se les permite 150 peticiones

por hora.

Basic llama autenticación se permiten 150 solicitudes por hora.

OAuth se permiten las llamadas 350 solicitudes por hora.

La API REST se usuario y basadas en IP, tipo de limitación. Autenticados llamadas a la

API son la medida contra el límite de velocidad que el usuario se autentica. llamadas sin

autenticar se deducen de la convocatoria anfitriones asignación de direcciones IP.

Tasa de límites se aplican a los métodos que lo solicite, la información comando GET de

HTTP. En general los métodos que utilizan la API HTTP POST para enviar datos a Twitter

no son la velocidad limitada, sin embargo, algunos métodos se están tasa limitado

ahora. Todos los métodos empleados en la documentación de la API se explica si se trata

de tasa limitado o no.

API de métodos que no están directamente tasa limitada siguen estando controlados por la

actualización diaria y los límites del seguidor para promover un uso saludable y desalentar

el spam. Estos límites de Twitter se describen en nuestro sitio de ayuda.Notas especiales acerca de los usuarios o de búsqueda

Los usuarios / search método tiene un límite de velocidad característica adicional que se

aplique en combinación con la tasa de API REST límite principal. Las llamadas a los

usuarios o de búsqueda se verá afectada por tanto la función y solicitar tasa límite

predeterminado. Si el límite se agota, el método fallará. Usted puede monitorear el estado

de la función de limitar la velocidad mediante la inspección de los encabezados de

respuesta HTTP que se devuelven.

Además de los encabezados de tipo de límite por defecto también verá:

X-FeatureRateLimit-Limit

X-FeatureRateLimit restante

X-FeatureRateLimit-Reset

El significado de estas cabeceras corresponden a los encabezados X-RateLimit

proporcionada por la API REST principales límite.

Saber si está limitada tasa deSi su solicitud está siendo limitado por la velocidad de la API REST que recibirá HTTP 400

códigos de respuesta. La mejor práctica para las aplicaciones para controlar su tasa de

estado límite actual y dinámica del acelerador peticiones si es necesario. La API REST

ofrece dos formas de observar esta situación que se explica en la limitación de velocidad

FAQ.

Lista blancaAlgunas aplicaciones encontramos que el límite por defecto resulta insuficiente. En tales

circunstancias, ofrecemos listas blancas. Es posible crear una lista blanca, tanto las

cuentas de usuario y las direcciones IP. Cada entidad lista blanca, ya sea una cuenta o

dirección IP, se permite 20.000 solicitudes por hora. Si está desarrollando una aplicación y

me gustaría ser considerado para listas blancas de llenar el formulario de solicitud de listas

blancas. Se revisan cada solicitud de listas blancas y algunas veces puede tomar una

semana para recibir una decisión. Una vez que hemos tomado la decisión le enviaremos la

dirección asociada a la cuenta de Twitter que presentó la solicitud.

Page 47: Documentacion Twitter

Actualización de los datos de su lista blanca

Si usted está lista blanca, pero sus circunstancias cambian debe volver a aplicar para la

lista blanca que explica el cambio y el que se haya previamente la lista blanca. Usted debe

volver a aplicar con la misma cuenta que utiliza para solicitar inicialmente lista blanca.Notas importantes

Lista blanca no quita la actualización diaria y los límites seguidor asociados a las

solicitudes POST, estos límites se manejan en una base por usuario.

lista blanca de propiedad intelectual tiene prioridad sobre los límites de la frecuencia de los

usuarios. Peticiones GET de una lista blanca de direcciones IP en nombre de un usuario

se deducirá de limitar la lista blanca de propiedad intelectual, no de los usuarios. listas

blancas basadas en IP, es la mejor práctica para las aplicaciones que tienen muchos

usuarios.

Usted puede verificar su lista blanca con las cuentas / rate_limit_status método. Para

recuperar el límite de la tarifa de usuario que debe llamar a este método con

autenticación. Para la tasa límite de dirección IP que deben hacer la solicitud de forma

anónima.

API de búsqueda de limitación de velocidadLas solicitudes a la API de búsqueda, alojado en search.twitter.com, no cuentan para el

límite de la API REST. Sin embargo, todas las solicitudes procedentes de una dirección IP

se aplican a una tasa límite de la búsqueda. La búsqueda Limitar la tasa no se hace

pública para desalentar el uso innecesario de búsqueda y los abusos, pero es mayor que

el resto Precio Límite. Creemos que la búsqueda Limitar la tasa es a la vez liberal y

suficiente para la mayoría de aplicaciones y conocimientos que la aplicación muchos

vendedores han considerado adecuado para sus necesidades.Requisitos para la API de búsqueda

Búsqueda uso de la API exige que las solicitudes incluyen un único usuario y la

identificación de cadena de agente. Un Referente HTTP se esperaba, pero no es

necesario. Las aplicaciones que utilizan la API de búsqueda, pero no incluir una cadena de

agente de usuario recibirá un límite de tasa más baja.

Una aplicación que excede las restricciones aplicables a la API de búsqueda, recibirá un

código de respuesta HTTP 420. La mejor práctica para observar esta condición de error y

el honor de Retry-Después de cabecera, que será devuelto. El Retry-After valor de

encabezado es el número de segundos que la aplicación debe esperar antes de pedir la

fecha de la API de búsqueda de nuevo.Buscar Lista blanca

No hay una lista blanca para la API de búsqueda de la misma manera que existe para la

API REST. Sin embargo, en algunas circunstancias raras hemos trabajado con los

desarrolladores para aumentar la limitación de velocidad para las aplicaciones de sus

solicitudes de búsqueda.

No damos lista blanca preventiva para la API de búsqueda sin embargo. Usted debe tener

una aplicación de trabajo que ha demostrado que requiere más capacidad antes de que

vamos a discutir listas blancas. Si usted cree que su solicitud está haciendo todo lo posible

para limitar las consultas y combinar en su caso puede contactar con la dirección de correo

electrónico en la página de soporte de la API para discutir sus necesidades.

Page 48: Documentacion Twitter

La API de búsqueda sólo es capaz de lista blanca las direcciones IP no, las cuentas de

usuario. En la mayoría de situaciones ha resultado adecuado.Buscar Lista blanca para plataformas Cloud

Una aplicación debe tener una dirección IP estática para poder optar a listas blancas. Esto

significa que la mayoría de las plataformas de nubes, incluyendo Google App Engine, no

puede ser la lista blanca.

Consejos para evitar ser Califica LimitadaLos siguientes consejos son la herramienta que está a la defensiva código y reducir la

posibilidad de la tasa está limitada.El almacenamiento en caché

Tienda respuestas API en su aplicación o en su sitio si usted espera un montón de

uso. Por ejemplo, no trate de llamar a la API de Twitter en cada carga de página de su sitio

web la página de destino. En su lugar, llame a la API con poca frecuencia y la carga de la

respuesta en una caché local. Cuando los usuarios afectados la carga sitio web de la

versión en caché de los resultados.Dar prioridad a los usuarios activos

Si su sitio hace un seguimiento de muchos usuarios de Twitter (por ejemplo, ir a buscar su

estado actual o estadísticas sobre su uso de Twitter), tenga en cuenta sólo los datos de su

interés para los usuarios que han firmado recientemente en su sitio.Adaptarse a los resultados de búsqueda

Si su aplicación supervisa un alto volumen de los términos de búsqueda, consulta con

menos frecuencia en las búsquedas que no tienen resultados que para aquellos que lo

hacen. Mediante el uso de un back-off puede mantenerse al día en las consultas que son

populares, pero no perder interés en los ciclos de las consultas que muy rara vez cambian.

Alternativamente, puede utilizar el API streaming y el filtro en la búsqueda de sus términos.

Listas negrasLe pedimos que honra el límite de velocidad. Si usted o su aplicación la tasa de abusos

límites se la lista negra. Si usted está en la lista negra, no podrá obtener una respuesta de

la API de Twitter.

Si usted o su aplicación ha sido la lista negra y creo que ha habido un error que puede

contactar con la dirección de correo electrónico en lapágina de soporte de la API. Así que

podemos conseguirle detrás en línea rápidamente por favor incluya la siguiente

información:1. Si está utilizando la API REST, hacer una llamada a

la 1/account/rate_limit_status / de la cuenta o una computadora que es la lista negra.

2. Explique por qué usted piensa que su solicitud ha sido la lista negra.3. Describir con detalle cómo se ha solucionado el problema que usted piensa que

hizo que la lista negra.

Streaming APILa API ha Streaming limitación de velocidad y niveles de acceso que son apropiados para

conexiones de larga duración. Consulte ladocumentación de la API de streaming para más

detalles.

Page 49: Documentacion Twitter

Limitación de velocidad FAQ

Tabla de contenidos ¿Dónde puedo encontrar información acerca de qué tipo de límite es?

Son límites de la frecuencia por usuario, por ordenador o por solicitud?

¿Por qué elegir el Twitter de la Copa Mundial de 2010 como un momento de comenzar

de forma dinámica la calificación de la API

¿Tiene cambio dinámico de la limitación afecta a todos los que usan la API?

Tengo una cuenta de la lista blanca y no puede operar con un límite de velocidad de

muy pequeño

¿Habrá alguna advertencia antes de que el límite se cambia?

¿Cuánto tiempo durará el límite de velocidad se reducirá?

¿Qué sucede cuando el límite de velocidad de tiempo de reposición que se llegó?

¿Cómo puedo comprobar el límite de velocidad?

Si usted tiene otra pregunta que no ha sido respondida, háganoslo saber en la lista de

correo de desarrolladores.

¿Dónde puedo encontrar información acerca de qué tipo de límite es?

Nuestro sitio web contiene recursos para desarrolladores de información general sobre

limitación de velocidad.

Son límites de la frecuencia por usuario, por ordenador o por solicitud?

Tasa de límites se aplican de diferentes maneras. Algunos métodos son limitados,

mientras que otros tipo de uso justo son limitados. En la mayoría de los métodos GET

(leer) las solicitudes son la velocidad limitada y POST (escribir) los métodos no lo

son. Usted debería revisar la sección tasa limitada de la documentación para el método

que desea utilizar para asegurarse.

Aplicamos las solicitudes de límites de la frecuencia de las siguientes maneras:

El precio de los límites de solicitudes autenticadas se aplican al usuario.

El precio de los límites de las solicitudes no autenticadas se aplican a la IP que vemos.

Esto significa que las aplicaciones comparten el límite de velocidad no autenticado Y el

límite autenticado. La aplicación se utiliza no hace ninguna diferencia para cambiar

entre varios clientes en la misma IP no ofrece ninguna ventaja límite de velocidad - que

todos ellos comparten el resto de peticiones misma.

Varias cuentas de usuario en un cliente de Twitter cada uno tiene su propio límite tasa de

usuario, pero que comparten las solicitudes no autenticadas.

Page 50: Documentacion Twitter

Búsqueda tiene su límite propio ritmo y, como todas las solicitudes son anónimas se aplica

a la IP que vemos. Esto significa que todos los usuarios de la misma IP compartida el

límite de velocidad de búsqueda.

¿Por qué elegir el Twitter de la Copa Mundial de 2010 como un momento de comenzar de forma dinámica la calificación de la API

El API representa aproximadamente el 75% del tráfico que viene, twitter.com. Mantener las

tasas bajo control. Esto significa que nuestra mejor oportunidad de llevar los servicios de

apoyo es disminuir la carga de lectura en el API.

¿Tiene cambio dinámico de la limitación afecta a todos los que usan la API?

Cuando se cambian los límites de frecuencia, todos los usuarios de la API lo sentirá. Esto

incluye las cuentas de la lista blanca y las aplicaciones propias de Twitter, incluyendo

Twitter para dispositivos móviles y m.twitter.com. Nosotros no discriminamos a nadie o dar

prioridad en el API, incluso nosotros mismos.

Tengo una cuenta de la lista blanca y no puede operar con un límite de velocidad de muy pequeño

Para garantizar la imparcialidad a todos los usuarios de la API, el límite de tipo reducido es

proporcional a esa solicitud o asignación de los usuarios en lugar de un valor fijo de las

solicitudes.

¿Habrá alguna advertencia antes de que el límite se cambia?No queremos que se está convirtiendo el tipo de límites hacia abajo y se evite hacer si

podemos, pero Twitter puede verse sobrecargado sin previo aviso. Si esto ocurre vamos a

intentar todo lo posible para restablecer el servicio antes de ajustar los límites de

velocidad.

servicio de restauración que tiene que ocurrir de forma rápida y medio, si el límite de

velocidad tiene que reducirse, se acaba de suceder. Es posible que califique limitado,

incluso cuando pensaba que había peticiones izquierda.

¿Cuánto tiempo durará el límite de velocidad se reducirá?Cuando se reduce el límite de velocidad vamos a observar cómo van las cosas y si es

necesario reducir la tasa adicional. Si las cosas se ven más saludables que evaluará si

aumentar el límite de velocidad de forma gradual hasta el límite por defecto se restablecen.

Vamos a dejar que todos ustedes saben acerca de los cambios por defecto límite de

velocidad de cualquier bien @twitterapi y la discusión la lista de correo de desarrolladores.

¿Qué sucede cuando el límite de velocidad de tiempo de reposición que se llegó?

El límite de tasa seguirá siendo el mismo que estaba antes del tiempo de reposición, sin

perjuicio de los cambios realizados.

¿Cómo puedo comprobar el límite de velocidad?Puede comprobar el límite de velocidad de una de dos maneras.

Encabezados de respuesta

Page 51: Documentacion Twitter

Cada vez que haga una solicitud a la API se remitirá el estado actual tasa a usted en la

cabecera de respuesta. Usted debe buscar las siguientes claves:

X-RateLimit-Limit: 350 X-RateLimit restante: 350 X-RateLimit-Reset: 1277485629

Solicite su límites de la frecuencia de la API

Hacer una llamada a la API a /

1/account/rate_limit_status.xml o 1/account/rate_limit_status.json /. Usted recibirá una

respuesta similar a:

("Reset_time_in_seconds" => 1277485629, "remaining_hits" => 350, "hourly_limit" => 350, "reset_time" => "vie 25 de junio 0000 17:07:09 2010")

Más información está disponible en la definición de API para rate_limit_status.

Las respuestas HTTP y errores

Códigos de estado HTTPLa API de Twitter intentos de una rentabilidad adecuada códigos de estado HTTP de todas

las solicitudes. Es posible suprimir los códigos de respuesta para la API REST.

200 OK: Success!

304 No modificado: No hubo nuevos datos para volver.

400 Bad Request: La solicitud no es válida. Un mensaje de error que acompañan a

explicar por qué. Este es el código de estado serán devueltos durante limitación de

velocidad.

401 No autorizado: las credenciales de autenticación era incompleta o incorrecta.

403 Forbidden: La solicitud se entiende, pero se ha negado. Un mensaje de error que

acompañan a explicar por qué. Este código se utiliza cuando las solicitudes están

siendo denegado debido a actualizar los límites.

404 Not Found: El URI solicitado no es válida o el recurso solicitado, como por

ejemplo un usuario, no existe.

406 No Aceptable: Volvió por el API de búsqueda en un formato no válido se

especifica en la solicitud.

420 Mejorar la calma: devuelto por la búsqueda y API Tendencias cuando usted está

siendo limitada tasa.

500 Internal Server Error: Algo se ha roto. Por favor, publique al grupo por lo que el

equipo de Twitter puede investigar.

502 Puerta de enlace incorrecta: Twitter está caído o se actualiza.

503 Servicio no disponible: Los servidores de Twitter han subido, pero sobrecargado

de peticiones. Inténtelo más tarde.

Mensajes de errorCuando la API de Twitter devuelve mensajes de error, lo hace en el formato solicitado. Por

ejemplo, un error de un método de XML puede ser como este:

<? Xml version = "1.0" encoding = "UTF-8"?> <hash> <request> / <Direct_messages/destroy/456.xml /> Solicitud de <error> Ningún mensaje directo con dicho ID encontrados. </ Error> </> hash

Page 52: Documentacion Twitter

Conteo de Caracteres

Twitter Tweet límites de longitud de 140 caracteres que la definición de un

"carácter" y la forma en que se cuentan fundamental para cualquier aplicación de

Twitter. Esta página tiene como objetivo proporcionar información sobre cómo el

código de Twitter en el servidor cuenta con personajes de la restricción de longitud

Tweet. Los ejemplos en esta página se facilitará sobre todo en el lenguaje de

programación Ruby, pero los conceptos deben ser aplicables a todos los idiomas.

Para los programadores con experiencia en procesamiento de Unicode la

respuesta corta a la pregunta es que la longitud de Tweet se mide por el número

de puntos de código en la versión normalizada de la Conferencia Nacional de

texto. Si eso es demasiado geek, siga leyendo y explicaré. Si eso no es demasiado

geek debe aplicar para trabajar en equipo internacional de Twitter.

Codificación de caracteres de Twitter Todos los atributos Twitter aceptar UTF-8 texto codificado a través de la

API. Todas las codificaciones de otros deben ser convertidos a UTF-8 antes de

enviarlos a Twitter a fin de garantizar que los datos no está dañado.

Definición de un conjunto de caracteres Mientras que Wikipedia tiene un artículo para un personaje (informática) es un

equipo muy técnico y vaga definición de propósito. La definición que nos interesa

aquí no es la definición general de un personaje de la informática, sino más bien la

definición de lo "carácter" se entiende cuando se dice "140 caracteres".

Para muchos píos todos los personajes son un solo byte y esta página no tiene

ninguna utilidad. El número de caracteres en un Tweet será igual a la longitud en

bytes del texto. Si utiliza nada más allá de las cartas más básicas, números y

puntuacion la situación se vuelve más confuso. Mientras que muchas personas

utilizan caracteres kanji multi-byte para ejemplificar estos temas, Twitter se ha

encontrado que las vocales acentuadas causan la mayoría de confusión debido a

los oradores Inglés simplemente esperar que funcionen. Tomemos el ejemplo

siguiente: \ la palabra "café". Resulta que hay dos secuencias de bytes que se ven

exactamente igual, pero utilizar un número diferente de bytes:

cafetería 0x63 0x61 0x66 0xC3 0xA9 Utilizando el carácter "e", llamado el carácter "integrado".

cafetería 0x63 0x61 0x66 0x65 0x81 0xCC Utilizando la combinación de diacríticos, que se superpone al "e"

Conteo de Caracteres Conceptos generales

El "café" ya se mencionó antes se plantea la cuestión de cómo contar los

caracteres en la cadena de Tweet "café". Para el ojo humano es claramente la

duración de cuatro caracteres. Dependiendo de cómo se representan los datos

podría ser cinco o seis bytes UTF-8. Twitter no quiere sancionar a un usuario por el

hecho de que usamos UTF-8 o por el hecho de que el cliente de la API en cuestión

Page 53: Documentacion Twitter

utiliza la representación más tiempo. Por lo tanto, Twitter no cuenta "café" de

cuatro personajes, no importa que la representación se haya enviado.

Casi todos los métodos de entrada del usuario se convierten automáticamente la

versión de marca ya que combina en la versión compuesta, pero la API de Twitter

no se puede contar con eso. Incluso si lo hiciéramos pasar por alto que la longitud

en bytes del carácter "e" es de dos bytes en lugar de la que cabría esperar. A

continuación hay alguna información más específica sobre cómo conseguir que la

información fuera de Ruby / Rails, pero por ahora me ocuparé de los conceptos

generales que deben estar disponibles en cualquier idioma.

El estándar Unicode cubre mucho más que una lista de caracteres con números

relacionados. Unicode proporciona una lista de "puntos de código" (más información), que es la U + XXXX notación a veces se ve. El estándar Unicode

también proporciona varias maneras diferentes para codificar los puntos de código

(UTF-8 y UTF-16-son ejemplos, pero hay otros). El estándar Unicode también

proporciona información detallada sobre cómo hacer frente a cuestiones de

carácter como clasificación, expresiones regulares y de importancia a esta

cuestión, la normalización. La combinación de los signos diacríticos - Un Preludio a la normalización

Por lo tanto, de vuelta en el café, el tema de múltiples secuencias de bytes con el

mismo-la representación en pantalla fue leí rápidamente por la derecha. Hay una

sección completa de las tablas Unicode dedicado a la "combinación de diacríticos

Marcas" (véase que el Unicode "bloque" aquí). Estos no son personajes de pie,

sola, sino que el adicional "signos diacríticos" que se añaden a los personajes de

base, en muchos idiomas. Por ejemplo el ¨ sobre la ü, común a Alemania, o la ~

sobre la "ñ" en español. Hay una gran multitud de combinaciones necesarias para

cubrir todos los idiomas del mundo para Unicode proporciona algunos bloques de

construcción simple, la combinación de diacríticos Marcas.

A los personajes más comunes (como é, ü y compañía) también hay un personaje

sólo para la combinación. Las razones por las que son en su mayoría históricos,

sino desde que existe, es algo que siempre tendrá que tener en cuenta. Esta

rareza histórica es la razón exacta de los dos "café" representaciones. Si miras

hacia atrás en las representaciones verás uno usa 0x65 0x81 0xCC,

donde 0x65 es simplemente la letra "e" y> 0xCC 0x81 es la combinación de

diacríticos para Marcos ". Puesto que hay múltiples maneras de representar lo

mismo usando el Estándar Unicode Unicode proporciona información sobre la

forma de normalizar las distintas representaciones múltiples. La normalización Unicode

El estándar Unicode proporciona información sobre diferentes tipos de

normalización, Canonical y compatibilidad. Hay una descripción completa de las

diferentes opciones en el estándar Unicode Anexo # 15, el informe sobre la

normalización. El informe de la normalización es de 32 páginas y abarca el tema

en gran detalle. La reproducción de todo el informe aquí sería de poco uso muy así

que en vez nos centraremos en lo que la normalización está utilizando Twitter.

Twitter cuenta la longitud de un Tweet utilizando el Formulario C Normalización

(NFC) versión del texto. Este tipo de normalización favorece el uso de una

combinación de carácter plenamente (0xC3 0xA9 cafetería del ejemplo) sobre la

Page 54: Documentacion Twitter

forma versión larga (0x65 0xCC 0x81). Twitter también cuenta el número de

puntos de código en el texto en lugar de UTF-8 bytes. El 0xC3 0xA9 del ejemplo

es un punto de código cafetería (U +00 E9) que se codifica como dos bytes en

UTF-8, mientras que 0x65 0x81 0xCC es de dos puntos de código codificado como

tres bytes.

Información específica de la Lengua Información específica de Ruby

En Ruby 1.8 caracteres de varios bytes se apoyan a través de la ActiveSupport::

multibyte clase. Esa clase proporciona un método para la normalización de

Unicode , pero lamentablemente los resultados de la longitud método no

intuitiva. Para algunos ejemplos echa un vistazo ahttp://gist.github.com/159484 ...

esto fue en realidad el script utilizado la hora de solucionar cuestiones de carácter

contar en la base de código en Twitter. Después de la experimentación se muestra

en lo esencial por encima nos quedamos con el siguiente código para el control de

la longitud Tweet (menos otros comentarios que lo rodean, que son una versión

reducida de esta página):

String display_length def ActiveSupport clase:: multibyte:: Chars.new (auto). Normalize (: c). End end longitud

Información específica de Java

Java fue el lenguaje utilizado por el Unicode Consortium para el ejemplo de cómo

hacer la normalización. El código original, junto con una demo del applet, se puede

encontrar en http://unicode.org/reports/tr15/Normalizer.html. Perl Información específica (y una herramienta de línea de comandos)

La World Wide Web Consortium (W3C) proporciona una herramienta de línea de

comandos escritos en Perl para llevar a cabo la normalización de caracteres. La

información sobre la última versión de esta herramienta se puede encontrar

en http://www.w3.org/International/charlint. Información específica de PHP

En la normalización de PHP se puede realizar por la clase Normalizer

Tweet Entidades

Tweet texto potencialmente se pueden mencionar otros usuarios, listas, contienen

las direcciones URL, y contienen hashtags - de hecho, aproximadamente el 50%

de los tweets contener por lo menos uno de ellos.

Los desarrolladores que quieren entender el texto tweet tiene que analizar el texto

para tratar de extraer de ellas las entidades (que es especialmente difícil cuando

se trata de caracteres Unicode) y luego tener que hacer otra llamada REST

potencialmente para resolver esos datos. Matt Sanford (@ mzsanford) en nuestro

equipo internacionalización publicado el texto-la colección de Twitter para ayudar a

hacer análisis más fácil y estandarizada (de hecho, nosotros usamos esta

biblioteca), pero en el equipo de la plataforma se preguntó si podíamos hacer esto

aún más fácil para nuestros los desarrolladores.

Page 55: Documentacion Twitter

Como parte de nuestro JSON y XML cargas útiles, vamos a empezar a apoyar a

un atributo de las entidades que contendrá esta información analizada y

estructurada.

En este tiempo son entidades opt-in y sólo está disponible para los métodos de

control temporal de la API. En el futuro, las entidades serán incluidos de forma

predeterminada.

Cada entidad extrae también incluirá los índices que indican en qué posiciones de

carácter de la entidad fueron extraídos de los Tweet original, un medio útil para el

entrenamiento de su aplicación de análisis propios.

Como siempre, es importante ser tolerante con los nuevos campos y vacío /

valores nulos en todas las devoluciones.

Representación XML En este ejemplo, el contenido original de la Tweet fue: "RT @ mashable @

LinkedIn refuerza sus Twitter Integración [FOTOS] http://bit.ly/bkB7cA LinkedIn #

tweets twitter # #" - observe cómo las menciones @, enlace y hashtags

representarse a sí mismos en la entidades elemento del estado:

<status> <created_at> mié 26 de mayo 0000 20:10:00 2010 </> created_at <id> 14785507974 </ id> <text> RT @ mashable @ LinkedIn refuerza sus Twitter Integración PICS] http://bit [ .ly/bkB7cA LinkedIn # tweets # <# twitter / texto> <a <source> href="http://tweetmeme.com" rel="nofollow"> tweetmeme </ a> </ source> < truncada false <> / truncado> <in_reply_to_status_id> </ in_reply_to_status_id> <in_reply_to_user_id> </ in_reply_to_user_id> <favorited> false </ favorited> <in_reply_to_screen_name> </ in_reply_to_screen_name> <usuario> <id> 17218077 </ id> <name> Mike Mostransky </ name> <screen_name> mikemost </ screen_name> <ubicación> UT: 40.696222, -73.500985 </ Location> <description> (este de cuenta contiene mis opiniones 2cent propia) Esposo, padre, fotógrafo, SocMedia Guy, de productos y encargado de la comunidad de La Red de Inversores y Accionistas Foro </ description> <profile_image_url> http://a1.twimg.com/profile_images/631496480/takeme_normal.jpg </ profile_image_url> <url> http:// <www.mostransky.com / url> <protected> false </ protegida> <followers_count> 1265 </ followers_count> <profile_background_color> ffffff </ profile_background_color> 5c544d <<profile_text_color> /> profile_text_color <profile_link_color> 000000 </ profile_link_color> < profile_sidebar_fill_color> ebefe7 </> profile_sidebar_fill_color <profile_sidebar_border_color> 000000 </> profile_sidebar_border_color <friends_count> 1996 </ friends_count> <created_at> Thu Nov 06 20:04:10 0000 2008 </> created_at <favourites_count> 288 </ favourites_count <> utc_offset> -18000 </ utc_offset> <time_zone> hora del Este (EE.UU. y Canadá) </> time_zone <profile_background_image_url> http://a1.twimg.com/profile_background_images/36708246/mo1449-R1-E018244.jpg </ profile_background_image_url > false <<profile_background_tile> /> profile_background_tile <notifications> false </ notificaciones> <geo_enabled> false </ geo_enabled> <verified> false </ verificado> <following> true </ siguiente> <statuses_count> 2694 </ statuses_count <> lang> es </ lang> false <<contributors_enabled> / contributors_enabled> </ usuario> <geo/> <coordinates/> <place/> <contributors/> <entities> user_mention final <<user_mentions> = "12" start = "3"> <id> 972651 </ id> <screen_name> <mashable / screen_name "nombre Pete Cashmore </> </ name> <user_mention end="22" user_mention start="13"> <id> 13058772 </ id> <screen_name> LinkedIn </ screen_name "nombre LinkedIn </ name> / user_mention> </ user_mentions> <urls> <url end="83" start="63"> <url> http:/ / bit.ly/bkB7cA </ url> </ url> </ URL> <hashtag <hashtags> end="93" start="84"> <text> <LinkedIn / texto> </ hashtag <> = fin hashtag "101" start = "94"> <text> tweets </ texto> </ hashtag>

Page 56: Documentacion Twitter

<hashtag end="110" start="102"> <twitter <text> / texto> </ hashtag> </ hashtags> </ entidades> </ status>

Representación JSON En este ejemplo, el contenido original de la Tweet fue: "Ayuda con el derrame de

petróleo usando @ # appcelerator de titanio y el impresionante @ intridea Reporter

Petróleo API. Http://bit.ly/dCueLT" - observe cómo las menciones @, enlace y

hashtag representan a sí mismos en laentidades elemento del estado:

("Coordenadas": null, "geo": null, "in_reply_to_user_id": null, "fuente": "web", "retweeted_status": ("coordenadas": ("type": "Punto", "coordenadas": [ -81.393913, 28.659501]), "geo": ("type": "Punto", "coordenadas": [28,659501, -81.393913]), "in_reply_to_user_id": null, "fuente": "<a href = \" http : / / \ www.tweetdeck.com "rel = \" nofollow \ "> TweetDeck </ a>", "usuario": ("url": "http://squarefactor.com", "descripción": "Interactive Estudio "," followers_count ": 205," time_zone ":" Tiempo del Este (EE.UU. y Canadá) "," Localización ":" Orlando, FL "," notificaciones ": false," friends_count ": 85", profile_sidebar_border_color ":" FFFFFF "," profile_image_url ":" http://a3.twimg.com/profile_images/58457461/address_square_normal.png "," statuses_count ": 375," profile_link_color ":" FAA419 "," profile_background_color ":" ffffff "," lang ":" es "," profile_background_image_url ":" http://a3.twimg.com/profile_background_images/88435161/twitter-bg.jpg "," favourites_count ": 4," profile_text_color ":" 5F5F5F "," screen_name " : "squarefactor", "contributors_enabled": false, "geo_enabled": true, "profile_background_tile": false, "protegidos": false, "después de": false, "created_at": "Mon 18 de agosto 0000 16:20:58 2008 "," profile_sidebar_fill_color ":" FFFFFF "," name ":" squareFACTOR "," verificado ": false," id ": 15893275," utc_offset ": -18.000)," in_reply_to_screen_name ": null," created_at ":" Miércoles 26 de mayo 0000 20:35:12 2010 "," colaboradores ": null," Favorito ": false," truncado ": false," ": 14786759290," anotaciones "id": null, "lugar": ("url ":" http://api.twitter.com/1/geo/id/e40595796da14879.json "," bounding_box ": (" type ":" Polígono "," coordenadas ": [[[-81.443484, 28.640162], [-81.343698, 28.640162], [-81.343698, 28.690035], [-81.443484, 28.690035]]]), "street_address ":""," FULL_NAME ":" Altamonte Springs, FL "," name ":" Altamonte Springs " "country_code": "EE.UU.", "id": "e40595796da14879", "país": "Los Estados Unidos de América", "place_type": "ciudad"), "in_reply_to_status_id": null, "text": "Ayuda con el derrame de petróleo usando @ # appcelerator de titanio y el impresionante @ intridea Reporter Petróleo API. http://bit.ly/dCueLT ")," usuario ": (" url ":" http://blog.gleep.org/ "," descripción ":" Software Architect y empresario, GT Alum, Hacker, Poeta, FIXIT "," followers_count ": 875," time_zone ":" Tiempo del Este (EE.UU. y Canadá) "," Localización ":" \ u00dcT: 33,96143, -84.351552 "," notificaciones ": false," friends_count ": 697," profile_sidebar_border_color ":" 829D5E "," profile_image_url ":" http://a1.twimg.com/profile_images/645226098/4Up_Combined_normal.jpg ", "statuses_count": 13891, "profile_link_color": "D02B55", "profile_background_color": "352726", "lang": "es", "profile_background_image_url": "http://s.twimg.com/a/1274144130/images / themes/theme5/bg.gif "," favourites_count ": 109," profile_text_color ":" 3E4415 "," screen_name ":" andrewwatson "," contributors_enabled ": false," geo_enabled ": true," profile_background_tile ": falso, "protegidos": false, "después de": true, "created_at": "22 de mayo mar 0000 23:14:42 2007", "profile_sidebar_fill_color": "99CC33", "name": "Andrew Watson", "verificado" : false, "id": 6247112, "utc_offset": -18.000), "in_reply_to_screen_name": null, "created_at": "Miércoles 26 de mayo 0000 21:02:58 2010", "entidades": ("urls": [("url": "http://bit.ly/dCueLT", "índices": [117, 137])], "hashtags":

Page 57: Documentacion Twitter

[("índices": [62, 71], "text": "titanio")], "user_mentions": [("índices": [3, 16], "screen_name": "squarefactor", "name": "squareFACTOR", "id": 15893275), ("índices": [48, 61], "screen_name": "appcelerator", "name": "Appcelerator", "id": 9662352), ("índices": [88, 97], "screen_name": "intridea", "nombre ":" Intridea, Inc. "," id ": 14455548)])," contribuyentes ": null," Favorito ": false," truncado ": false," id ": 14788112220," lugar ": null," in_reply_to_status_id ": null," text ":" RT @ squarefactor: Ayuda con el derrame de petróleo usando @ # appcelerator de titanio y el impresionante @ intridea Reporter Petróleo API. http://bit.ly/dCueLT ")

Streaming Documentación de la API

IntroducciónEl Twitter Streaming API permite el acceso en tiempo real, cerca de varios subconjuntos

de estados públicos Twitter. Los desarrolladores se les anima a leer toda la documentación

relacionada con el presente documento a fondo.

Conceptos

Métodos y parámetros de consulta

Los códigos de respuesta HTTP

Pre-lanzamiento ListaAntes de lanzar tu aplicación Streaming API, nosotros recomendamos que a través de esta

breve lista de verificación.1. No intencionalmente tratando de eludir los límites de acceso y los niveles?2. Crear el número mínimo de conexiones?3. Evitar la duplicación de datos de acceso?4. Copia de seguridad de los fracasos: ninguno para desconectar primero,

segundo de la red repetidas (TCP / IP) los temas a nivel, a pocos minutos de repetir HTTP (4XX) los códigos?

5. Uso de conexiones de larga duración?6. Tolerante a otros objetos y saltos de línea en el flujo de margen de beneficio?

(No <status> objetos ...)7. Tolerante de mensajes duplicados?8. Uso de JSON, si es posible?

API de búsqueda de documentación

Aviso: A partir del 01 de abril 2010, la API de búsqueda proporciona una opción para

obtener los "tweets popular", además de tiempo de búsqueda en los resultados reales. En

una próxima versión, esta se convertirá en el predeterminado y clientes que no desean

recibir tweets popular en sus resultados de búsqueda tendrán que explícitamente

señalar. Véase el parámetro tipo_resultado abajo para más información.

Advertencia: Los identificadores de usuario en la API de búsqueda son diferentes de los

de la API REST (sobre las dos APIs). Este defecto está siendo controlada por Número

214. Esto significa que el campo y from_user_id to_user_id varían de que el usuario

realmente id en Twitter.com. Las solicitudes se tienen que realizar una búsqueda basada

en el nombre de pantalla con los usuarios / mostrar método para obtener el ID de usuario

correcto si es necesario.URL

http://search.twitter.com/search.formatoFormatos soportados

json, átomométodos apoya la solicitud de

Page 58: Documentacion Twitter

GETRequiere autenticación

falsas qué se trata »de autenticaciónCalifica Limitada

verdadera tasa de limitar »Parámetros

Necesario qConsulta de búsqueda. En caso de presentar una URL codificada. Las consultas se

verá limitado por la complejidad.o http://search.twitter.com/search.json?q = @ NoRadio

Opcional de devolución de llamadaSólo disponible para el formato JSON. Si corresponde,

la respuesta se utiliza el formato JSONP con una devolución de llamada del nombre

de pila.

langRestringe tweets a la lingüística, dado por un código ISO 639-1.

lugarEspecifique el idioma de la consulta que está enviando (sólo ja es actualmente

efectiva). Esto está pensado para clientes específicos de lengua y el valor por defecto

debería funcionar en la mayoría de los casos.o http://search.twitter.com/search.json?locale=ja

rppEl número de tweets a ida y vuelta por la página, hasta un máximo de 100.o http://search.twitter.com/search.json?rpp=100

páginaEl número de página (a partir de 1) para volver, hasta un máximo de alrededor

de 1500 resultados (basados en * la página rpp).o http://search.twitter.com/search.json?page=10

since_idDevuelve resultados con un ID mayor que (es decir, más reciente que) el ID

especificado. Hay límites para el número de tweets que se puede acceder a través de

la API. Si el límite de Tweets haya producido desde el since_id, el since_id se verán

obligados a la más antigua de identificación disponibles.o http://search.twitter.com/search.json?since_id=12345

hastaFacultativo. Devuelve tweets generados antes de la fecha determinada. Fecha

deben tener el formato AAAA-MM-DD.o http://search.twitter.com/search.json?until=2010-03-28

codificación geográficaDevuelve tweets de los usuarios ubicados en un radio

determinado de la libertad dejada / longitud.La ubicación es preferentemente tomando

de la API de Geotagging, pero caerá de nuevo a su perfil de Twitter. El valor del

parámetro especificado por "latitud, longitud, radio", donde las unidades de radio

deben ser especificados como cualquier otro"mi"(millas)

o"kilometros"(kilómetros). Tenga en cuenta que no puede utilizar el operador de

cerca a través de la API para códigos geográficos lugares arbitrarios, pero usted

puede utilizar esta codificación geográfica parámetros para buscar, cerca de la

codificación geográfica directamente.o http://search.twitter.com/search.json?geocode=37.781157, -122.398720,1 millas

show_userCuando cierto, antepone ": "Al principio del paño de lana. Esto es útil para

los lectores que no se muestran de campo autor Atom. El valor predeterminado

es falso.

tipo_resultadoFacultativo. Especifica qué tipo de resultados de búsqueda que

preferiría recibir. El actual por defecto es "mixta". Los valores válidos son:

Page 59: Documentacion Twitter

o mixtos: Incluir popular tanto tiempo real y los resultados en la respuesta.

o recientes: devolver sólo los resultados más recientes en la respuesta

o populares: devolver sólo los resultados más populares en la respuesta.

o http://search.twitter.com/search.json?result_type=mixed

o http://search.twitter.com/search.json?result_type=recent

o http://search.twitter.com/search.json?result_type=popular

Ejemplo peticionesJSON

1234567891011121314151617181920212223242526272829

("resultados": [ ("texto":"@ twitterapi http:\ /\ /tinyurl.com\ /ctrefg", "to_user_id":396524, "to_user":"TwitterAPI", "from_user":"jkoum", "metadatos": ( "tipo_resultado":"populares", "recent_retweets": 100

), "id":1478555574, "from_user_id":1833773, "iso_language_code":"nl", "fuente":"<a href ="http:\/\/twitter.com\/"> twitter <\ /a>", "profile_image_url":"http:\ /\ /s3.amazonaws.com\ /twitter_production\ /profile_images\ /118412707\ /2522215727_a5f07da155_b_normal.jpg", "created_at":"Wed, 08 Apr 2009 19:22:10 0000"), ... truncunted ...] , "since_id":0, "max_id":1480307926, "refresh_url":"? since_id = 1480307926 & q 40twitterapi% =", "results_per_page":15, "next_page":"? page = 2 & max_id = 1480307926 & q =% 40twitterapi", "completed_in":0.031704, "Página":1, "consulta":"% 40twitterapi"))

Extendido DiscusiónNotas de uso:

cadenas de consulta debe URL codificada.

Las consultas pueden ser limitados por la complejidad

Algunos usuarios  pueden estar ausentes de los resultados de búsqueda.

El since_id parámetro será eliminado a partir del elemento next_page ya que no es

compatible con la paginación. Si since_id se extrae una alerta se añadirá a avisarle.

Este método devolverá un error HTTP 404 si since_id se utiliza y es demasiado viejo

para estar en el índice de búsqueda.

Si tiene problemas para la construcción de su consulta, utilice el formulario de

búsqueda avanzada para construir su búsqueda, a continuación, agregue el

formato. Por ejemplo http://search.twitter.com/search?q=twitter se convertiría

en http://search.twitter.com/search.json?q=twitter

Las solicitudes deberán tener un significativo y único agente de usuario al usar este

método. Un Referente HTTP se esperaba, pero no es obligatorio. Búsqueda de tráfico

que no incluye un Agente de Usuario serálimitada tasa a menos llamadas a la API por

hora que las aplicaciones, incluido un agente de cadena de usuario.

Page 60: Documentacion Twitter

Después de 01 de abril 2010 tenemos una nueva función para el retorno de tweets

popular en beta. Después del período de prueba el valor de tipo_resultado = mixta se

convertirá en el predeterminado.

Ejemplo consultas:

Que contengan una palabra: http://search.twitter.com/search.atom?q=twitter

Desde un usuario: % http://search.twitter.com/search.atom?q=from 3Aal3x

En respuesta a un usuario (Tweet comienza con @ mzsanford): %

http://search.twitter.com/search.atom?q=to 3Amzsanford

La mención de un usuario (tweet contiene @

biz): http://search.twitter.com/search.atom?q 40biz% =

Con un contenido hashtag (hasta 16 caracteres): http://search.twitter.com/search.atom?

q 23haiku% =

Combine cualquiera de los operadores entre sí: http://search.twitter.com/search.atom?

q=happy+hour&until=2009-03-24

Proveniente de una aplicación: http://search.twitter.com/search.atom?

q=landing+source:tweetie

Operadores de búsqueda:

La mayoría de los operadores de búsqueda se puede utilizar con las consultas de la API.

operadores booleanos:

OR para combinar consultas:o Mencionar @ twitterapi o Twitter @: http://search.twitter.com/search.atom?q =

40twitterapi + O + 40twitter%%

Negación: lugar - en frente de la operadora.o Hacer referencia a un usuario, pero no de ese usuario: %

http://search.twitter.com/search.atom?q=dougw+-from 3Adougw

Límites del operador:

desde: y hasta los operadores:o desde: devolverá un HTTP 404 si se es demasiado viejo

o hasta que: no puede ser en el futuro

o desde: y hasta que: no aceptan la negación (-) la operación

filtro: operador de enlaces:o Estos resultados están limitados a 7 días

fuente: operador:o Estos resultados están limitados a 7 días

o consultas debe contener al menos un parámetro con la palabra clave de

la fuente: operador

lang = operador:o Estos resultados están limitados a 7 días

ubicación del operador:o Estos resultados están limitados a 7 días

cerca de operador:o no se puede utilizar la API de búsqueda

operador de códigos geográficos:o no es compatible con la disyunción (OR)

Notas sobre los metadatos en las respuestas:

Page 61: Documentacion Twitter

Los metadatos nodo a veces contienen una tipo_resultado campo con un valor de

cualquiera de las recientes "o" popular "- aunque otros valores puede ser posible en el

futuro. Popular resultados son obtenidos por un algoritmo que calcula Twitter, y hasta 3 se

publicará en "modo mixto" en la parte superior del conjunto de resultados. resultados

Popular incluirá también otro nodo de metadatos llamado "recent_retweets" y se indicará

cómo retweets muchos tweet fue otorgado recientemente. El nodo de metadatos contienen

más campos como el paso del tiempo.

Refrescante Resultados de la búsqueda

Para los reproductores de cliente usando la búsqueda lateral, de forma predeterminada la

primera solicitud podría incluir resultados populares. Si desea mostrar todo esto puedes

usar el atributo tipo_resultado visualmente a diferenciarlos. Si no desea mostrar estos

siempre puede pasar el tipo_resultado "parámetro con un valor de" recientes ", junto con

su solicitud y que nunca ser incluidos.

En el caso de que usted les está mostrando, es posible que no quieren no los vuelva a

mostrar cada vez que actualiza widget. Cada carga resultado incluirá el since_id que

puedes usar en posteriores solicitudes para obtener los resultados más recientes. Si usted

está usando este since_id (que cumple todos los widgets de búsqueda debe), entonces los

resultados populares serán excluidos en las solicitudes posteriores. El valor since_id

específicos para pasar a la cadena de consulta está incluido en la carga útil. Estos son

algunos ejemplos en diversos formatos:

JSON:"Refresh_url": "? Since_id = 9290798834 & q = i"

átomo:type="application/atom+xml" <link href="http://search.twitter.com/search.atom?q=i&since_id=9290738270" rel="refresh"/>

rss:<twitter:refresh_url> http://search.twitter.com/search.rss?q=i&since_id=9290775688 </ twitter:> refresh_url

Twitter @ Anywhere es una de implementar una solución fácil para llevar la plataforma de

comunicación Twitter a su sitio. @ En cualquier lugar promueve una base de usuarios más

comprometida para su sitio. Utilice @ en cualquier lugar para añadir Siga Botones,

Hovercards, Linkify nombres de usuario de Twitter, y construir más profunda integración

con "Conectar a Twitter".

¿Necesitas ayuda? Pruebe la @ en cualquier lugar desarrolladores la lista de correo

Primeros pasosLo primero es lo primero, usted va a necesitar una aplicación cliente registrado con Twitter

para comenzar. Si bien puede utilizar una aplicación existente, es recomendable que cree

uno nuevo para @ en cualquier lugar. Para funcionar, la URL de llamada de la propiedad

de su solicitud debe contener el subdominio y el dominio de la aplicación web utilizando @

en cualquier lugar.

Crear un @ en cualquier lugar »de aplicación

En cualquier página HTML que desea utilizar @ en cualquier lugar, simplemente incluya una <script> etiqueta se sitúan en nuestros recursos en cualquier lugar @ JavaScript

en http://platform.twitter.com/anywhere.js, adjuntando su clave de API (id =) y En

Page 62: Documentacion Twitter

cualquier lugar de la @ versión (v =) que desea utilizar como parámetros de consulta en

la URL. Como práctica recomendada siempre coloque el archivo anywhere.js tan

cerca de la parte superior de la página como sea posible. (Para más información sobre

por qué esto es importante, ver las Mejores Prácticas sección de abajo.)

<! DOCTYPE HTML> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title> en cualquier lugar de ejemplo </ title> <script src = " http://platform.twitter.com/anywhere.js?id=YOUR_API_KEY&v=1 "type =" text / javascript "> </ script> </ head> <body> ... </ body> </ html>

El archivo JavaScript @ en cualquier lugar, establece un objeto global único (twttr). Para

usar en cualquier lugar @, llame a la cualquiermétodo, y pase una devolución de

llamada. La devolución de llamada recibirá una instancia de la API de cliente de Twitter

(llamada "T" por convención) como único argumento. Toda la @ en cualquier lugar las

funciones están disponibles como miembros de la API de cliente de Twitter. Por ejemplo, para utilizar Hovercards simplemente llame al hovercards método:

Ejemplo de inicialización

type="text/javascript"> <script twttr.anywhere (función de (T) (T.hovercards ();)); </ script>

Cualquier página puede tener varias llamadas a la cualquier método. El ejemplo

siguiente realiza dos llamadas al lugar método, una para Hovercards, y otro para crear

un botón Seguir.

<! DOCTYPE HTML> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title> en cualquier lugar de ejemplo </ title> <script src = " http://platform.twitter.com/anywhere.js?id=YOUR_API_KEY&v=1 "type =" text / javascript "> </ script> </ head> <script type="text/javascript"> <body> twttr . en cualquier lugar (función de (T) (T.hovercards ();)); </ script> ... <id="follow-placeholder"> <span / span> <script type="text/javascript"> twttr. en cualquier lugar (función (T) (T ("# seguimiento de marcador de posición"). followButton ('en cualquier lugar');)); </ script> </ body> </ html>

@ En cualquier lugar Características Auto-Linkification de nombres de usuario de Twitter

Hovercards

Siga botones

Tweet Caja

Inicio de sesión y registro

Auto-Linkification de nombres de usuario de Twitter@ Anywhere proporciona una manera conveniente para vincular nombres de usuario de

Twitter en su sitio web o aplicación de vuelta a la página de perfil en Twitter.com un

usuario. Un nombre de pantalla de Twitter es un símbolo '@' seguido de 1 a 20 caracteres

alfanuméricos, incluyendo guiones bajos (" _ "). @ ev o @ biz y dos ejemplos de nombre

de usuario de Twitter.

Para automáticamente nombres de usuario Linkify Twitter, simplemente llame T.linkifyUsers ():

Page 63: Documentacion Twitter

type="text/javascript"> <script twttr.anywhere (función de (T) (T.linkifyUsers ();)); </ script>

Llamadas linkifyUsers de esta manera tratar de Linkify todos los posibles usuarios de

Twitter en el <body> de la página.

Para limitar el alcance de lo que es linkified, simplemente pasar un selector CSS a la API

de cliente de Twitter (T). Por ejemplo, para Linkify sólo los nombres de usuario de Twitter

se encuentra en un elemento con el id de "-esto-" contenido Linkify, pase el selector "#

Linkify-este de contenido" a T:

type="text/javascript"> <script twttr.anywhere (función de (T) (T ("# Linkify-este contenido"). linkifyUsers ();)); </ script>

Ejemplo Linkify

@en cualquier parte fue posible gracias a @DED, @dsa, @todd, @danwrong, @NoRadio,

y al resto de la @Twitter equipo.linkifyUsers, y la mayoría de nuestros otros métodos de la API, tomar algunas

opciones de configuración adicional. Por ejemplo, por defecto, los nombres de usuario

linkifying se ajustará emparejado nombres en un elemento ancla con una clase de "twitter-en cualquier lugar del usuario": <a class='twitter-anywhere-user'> </

a>. Usted puede especificar un nombre de clase alternativo pasando un objeto literal y

establecer el valor de la className propiedad a nombre de la clase deseo. Por ejemplo,

para cambiar la clase a "mi-tweep":

type="text/javascript"> <script twttr.anywhere (función de (T) (T ("# Linkify-este contenido"). linkifyUsers ((className: "mi-tweep '));)); </ script >

HovercardsHovercards son una característica que se puede ver en Twitter.com y ahora están

disponibles para los desarrolladores a través de @ en cualquier lugar. Un Hovercard es

una, sensible al contexto pequeña descripción que proporciona acceso a los datos acerca

de un usuario de Twitter. Hovercards también permite a un usuario para decidir acerca de

un usuario de Twitter como seguir y unfollowing, así como alternar actualizaciones del

dispositivo.Hovercards

@en cualquier lugar fue posible gracias a @DED, @dsa, @todd, @danwrong, @NoRadio,

y el resto de la @twitter equipo.

La forma más fácil para que Hovercards en un sitio web o aplicación web es llamar simplemente la hovercards método:

type="text/javascript"> <script twttr.anywhere (función de (T) (T.hovercards ();)); </ script>

Por defecto, el hovercards método implícitamente llamar a la linkifyUsers método

contra el cuerpo del documento. Hovercards será habilitado en mouseover para todas las

etiquetas de anclaje se pongan en venta el nombre de clase demora aplicado por el linkifyUsersmétodo (<a class = 'twitter-en cualquier parte del usuario "> </ a>).

Page 64: Documentacion Twitter

Hovercard las opciones de configuración

Para limitar el alcance de Hovercards donde aparecen, simplemente pasar un selector CSS a la API de cliente de Twitter (T), a continuación, llamar a la hovercards método. El

siguiente ejemplo ilustra la forma de limitar Hovercards a un elemento con un id de

"principal de contenido":

type="text/javascript"> <script twttr.anywhere (función de (T) (T ("# principal de contenido"). hovercards ();)); </ script>

Deshabilitar linkifying de nombres de usuario de Twitter

Como se mencionó anteriormente, el hovercards método implícitamente llamar a

la linkifyUsers método contra el cuerpo del documento. Si los nombres de usuario de

Twitter ya se han linkified del lado del servidor según el mismo patrón utilizado por el linkifyUsers método, entonces es posible para impedir la hovercards método de

linkifying usuarios superando un literal de objeto como un argumento al llamar ahovercards y ajuste de la Linkify propiedad a falsas.

type="text/javascript"> <script twttr.anywhere (función de (T) (T ("# principal de contenido"). hovercards ((Linkify: false));)); </ script>

Uso de la inferir opción

Usar la inferir opción para activar Hovercards en elementos cuyo texto contiene un

nombre de usuario de Twitter. Cuando el inferir opción se utiliza,

el hovercards método no llamará a la linkifyUsers método. Esto es útil cuando los

nombres de usuario de Twitter ya se han linkified por cualquier otro medio. Por ejemplo: <a

...> Siga @ biz en Twitter </ a>

El siguiente ejemplo ilustra cómo utilizar las inferir opción.

type="text/javascript"> <script twttr.anywhere (función de (T) (T ("# de contenido a.my principal tweep"). hovercards ((inferir: true));)); </ script>

Especificar un nombre de usuario función

El nombre de usuario función permite una Hovercard de activarse con un elemento

cuando el nombre de usuario de Twitter es parte de un elemento de atributos (como el

título) en lugar de texto interno del elemento. Para especificar un nombre de usuario función simplemente pasar un objeto literal a la hovercards método, pasando una

referencia de funciones como el valor para el usuario la propiedad. La función se le

pasará una referencia al nodo DOM que hacía juego con el selector de pasar a la API de

cliente de Twitter (T). La función se puede realizar ninguna lógica (recorridos, atributo

búsquedas, manipulaciones) necesarias para extraer y devolver el nombre de usuario. Nota: Al igual que lainferir opción, cuando el nombre de usuario se utiliza

la opción, el hovercards método no llamará a la linkifyUsers método.

En el siguiente ejemplo el nombre de usuario función está definida para extraer un

nombre de usuario de Twitter en el texto de un elemento de imagen alt atributo.

type="text/javascript"> <script twttr.anywhere (función de (T) (T (sección "#> img"). hovercards ((nombre de usuario: function (nodo) (node.alt return;)));)) ; </ script>

Page 65: Documentacion Twitter

El uso de cualquiera de las inferir o nombre de usuario opciones, no llame a

la linkifyUsers método. Para Linkify y añadir Hovercards de los nombres de pantalla

desconectó además de Hovercards a otros elementos, puede llamar al hovercards método tantas veces como sea necesario.

type="text/javascript"> <script twttr.anywhere (función de (T) (T.hovercards (); T ("# de contenido a.my principal tweep"). hovercards ((nombre de usuario: function (nodo) ( node.title retorno;)));)); </ script>

Rasgando Hovercards ampliado de forma predeterminada

Por defecto se muestra un Hovercard usuario un nombre, nombre de usuario de Twitter, y

la ubicación. Cuando el usuario hace clic en el botón "Más" en un Hovercard, se expandirá

para mostrar información adicional, como usuario de la bio y su último Tweet. Para hacer

Hovercards en este estado ampliado de forma predeterminada, pasar un literal de objeto como un argumento al llamar a la hovercards método y establecer la propiedad

ampliado en true.

type="text/javascript"> <script twttr.anywhere (función de (T) (T ("# principal de contenido"). hovercards ((ampliado: true));)); </ script>

Siga botonesSiga botones facilitan que los usuarios de su sitio o aplicación con una manera de seguir a

los usuarios en Twitter. Agregar Siga botones a su sitio web o aplicación web es muy fácil: sólo tienes que llamar T pasa, en el selector de indicar dónde desea que el botón Seguir a

aparecer, y llame a la followButton método de especificar un nombre de usuario de

Twitter.

El siguiente ejemplo pone un botón Seguir para el usuario de Twitter llamado @ twitterapi en el <span> elemento con un id de "seguimiento twitterapi":

id="follow-twitterapi"> <span </ span <script type="text/javascript">> twttr.anywhere (función de (T) (T ('# seguimiento twitterapi »). followButton (" twitterapi "); )); </ script>

Siga Botones

 

Twitter @ en cualquier lugar Siga botones son inteligentes en que reflejan si el usuario

actual ya sigue el miembro. Si el usuario ya está siguiendo el usuario para un determinado

botón Seguir, la etiqueta del botón se actualizará con el texto "Estás siguiendo @" nombre

de usuario.Si el usuario intenta seguir un usuario de Twitter que está protegido, el

seguimiento de la etiqueta del botón se actualizará con el texto "el por @ username" en

espera de Seguimiento. Por último, si hubo un error cuando un usuario intenta seguir a una

persona, el seguimiento de Button etiqueta se actualizará para decir "No se pudo seguir @

nombre de usuario"

Tweet CajaLa caja permite a los usuarios de Twitter Tweet Tweet directamente desde su sitio web o aplicación web. Para utilizar la caja de Tweet, llame Tpasa, en el selector de indicar dónde

desea que el cuadro Tweet a aparecer, y llame a la tweetBox método.

Page 66: Documentacion Twitter

En el ejemplo siguiente coloca un cuadro en el Tweet <div> con el id de "TBox":

<div id="tbox"> </ <script div> type="text/javascript"> twttr.anywhere (función de (T) (T ("# TBox"). tweetBox ();)); </ script>

Configuración de la Caja Tweet

La Caja ha Tweet varias opciones de configuración. Todas las opciones de configuración

se establecen a través de un literal de objeto se pasa como un argumento a la tweetBox método.

El siguiente ejemplo ilustra cómo configurar un cuadro de Tweet con una anchura a

medida, altura y el contenido predeterminado.

<div id="tbox"> </ <script div> type="text/javascript"> twttr.anywhere (función de (T) (T ("# TBox"). tweetBox ((height: 100, ancho: 400, defaultContent: "<su DEFAULT TWEETBOX CONTENIDO aquí>"));)); </ script>

La siguiente tabla muestra todas las opciones de configuración de la caja de Tweet.Tweet configuración de la caja de Opciones

Parámetro Valores esperados Defecto Descripción

contador Booleano verdadero Mostrar un contador en la Caja para el recuento de caracteres Tweet

altura Número 515 (px) La altura de la caja de Tweet en píxeles

ancho Número 65 (px) La anchura de la caja de Tweet en píxeles

etiqueta Cadena "¿Qué está pasando?"

El texto anterior de la caja Tweet, un llamado a la acción.

defaultContent

Cadena ninguno Se completa automáticamente el texto en el cuadro de Tweet. Útil para una mención @, un hashtag #, un enlace, etc

onTweet Función ninguno Especifique un oyente para cuando un tweet se envía desde la caja de Tweet. El oyente recibe dos argumentos: un tweet texto plano y HTML un Tweet

datos Objeto ninguno Tecla + pares de valores que representan cualquiera de los metadatos adicionales que se pueden establecer cuando se actualiza el estado de un usuario. Consulte la documentación de la API REST para obtener una lista completa de las opciones posibles.

Éstos son algunos ejemplos de cómo hacer Tweet Cajas.

Page 67: Documentacion Twitter

Tweetbox

Advertencia: Estos son viveros pío. Si Tweet - se le pío.DefectoCostumbre

Inicio de sesión y registroAlgunos @ en cualquier lugar funcionalidad no requiere el usuario para acceder a Twitter o

autorizar su sitio de acceso. Una vez ejemplo sería ver perfil de Twitter de información en

un determinado una Hovercard. Otras funcionalidades, como ser capaz de seguir un

usuario en Twitter a través del seguimiento del botón, se requiere el usuario el usuario

para acceder a Twitter y autorizar su sitio de acceso. Cuando se conecte el usuario y la

autorización es necesario, en cualquier lugar @ maneja todo eso para usted fuera de la

caja.

El "Connect with Twitter" botón proporciona un método para autenticar a los usuarios de

forma segura con Twitter, cediendo su aplicación con un testigo de acceso para su uso en

llamadas a la API.

La adición de "Conectar con Twitter" para su aplicación es fácil: sólo tienes que llamar T pasando por un selector que indica donde desea que aparezca el botón, y llame a

la ConnectButton método.

Por ejemplo, el siguiente lugar una "Conectar con Twitter" en el botón <span> elemento

con un id de "entrada":

id="login"> <span </ span <script type="text/javascript">> twttr.anywhere (función de (T) (T ("# login"). ConnectButton ();)); </ script>

"Conectar con Twitter" botones tienen una gama de tamaños para elegir: medianas,

grandes, pequeñas Xlarga. "Medio" es el tamaño predeterminado. Usted puede especificar

el tamaño de la siguiente manera:

id="login"> <span </ span <script type="text/javascript">> twttr.anywhere (función de (T) (T ("# login"). ConnectButton ((size: "grande")); )); </ script>

Custom "Conectar con Twitter" Botón

Si la apariencia por defecto de la opción "Conectar con Twitter" botón no se ajustan a sus

necesidades, @ en cualquier lugar hace que sea fácil de construir un botón personalizado. La API de cliente de Twitter (T) pasa de nuevo a cada twttr.anywhere de devolución de

llamada tiene uncantanto método que proporciona toda la funcionalidad de la norma

"Connect with Twitter" botón. Para construir una costumbre "Connect with Twitter" botón

simplemente crear un botón utilizando HTML y CSS y obligar a un detector de eventos

click que llama al método cantanto. Por ejemplo:

<button type="button" id="signin-btn"> Conectar con Twitter </> <script type="text/javascript"> botón twttr.anywhere (función de (T) (document.getElementById ("btn-cantanto" ). onclick = function () (T.signIn (););)); </ script ">

Conectado con flujo de Twitter

Si los usuarios de su sitio web o aplicación web ya está registrado en Twitter, haciendo clic

en la opción "Conectar con Twitter" botón popup una ventana que contiene la pantalla en

cualquier lugar seguro @ autorización.

Page 68: Documentacion Twitter

Si el usuario no ha iniciado sesión en a Twitter, la opción "Conectar con Twitter" botón

popup una ventana que contiene la pantalla en cualquier lugar seguro @ autorización que

solicita al usuario que tanto acceder a Twitter, así como autorizar a su solicitud de acceso.La determinación del Estado de Conexión

@ Anywhere proporciona varias maneras de determinar cuando los usuarios de su sitio

web o aplicación web ha entrado en Twitter y autorizada su solicitud de acceso. Uso de la   authComplete   y   SignOut   Eventos

Trabajar con el usuario actual Uso de la authComplete y SignOut Eventos

@ Anywhere proporciona una authComplete y SignOut caso de que se puede utilizar

para determinar si procede o no a los usuarios de su sitio web o aplicación web ha entrado

en Twitter y autorizada su solicitud de acceso.

Utilizando la opción "Conectar con Twitter" botón es posible obligar a los oyentes, tanto para el authComplete y SignOut eventos a través de un literal de objeto se pasa

al ConnectButton método. Oyentes de la authComplete se pasan al usuario

conectado como un solo argumento.

id="login"> <span </ span <script type="text/javascript">> twttr.anywhere (función de (T) (T ("# login"). ConnectButton ((authComplete: function (usuario) (/ / desencadena cuando autoridades completado con éxito), SignOut: function () (/ / activa cuando el usuario cierra la sesión)));)); </ script>

El authComplete y SignOut eventos también son accesibles a nivel mundial en el

cliente de la API de Twitter ejemplo (T), que te permite escuchar por ellos cuando son

activados por cualquier @ en cualquier lugar funcionalidad. El siguiente ejemplo muestra cómo añadir detectores para el mundial authComplete y SignOut eventos:

type="text/javascript"> <script twttr.anywhere (función de (T) (T.bind ("authComplete", function (e, usuario) (/ / activa cuando autoridades completado con éxito)); T.bind ("SignOut ", function (e) (/ / activa cuando el usuario cierra la sesión));)); </ script>

Page 69: Documentacion Twitter

Trabajar con el usuario actual

El isConnected método se puede utilizar para determinar si el usuario ya ha iniciado

sesión ha autorizado a su sitio web o aplicación. Cuando el usuario está conectado el CurrentUser propiedad se puede utilizar para recuperar información sobre el usuario

conectado. El usuario tiene un objeto de datos método que se puede pasar una cadena

que representa el propertyto recuperar.

El siguiente ejemplo ilustra cómo usar jQuery y @ en cualquier lugar para mostrar

condicionalmente ya sea una conexión con Twitter botón, o el usuario de la pantalla el

nombre y la imagen de perfil si ya han autenticado.

id="twitter-connect-placeholder"> <span </ span <script type="text/javascript">> twttr.anywhere (función de (T) (var CurrentUser, ScreenName, profileImage, profileImageTag; if (T.isConnected ( )) (= CurrentUser T.currentUser; ScreenName currentUser.data = ('screen_name'); profileImage currentUser.data = ('profile_image_url'); profileImageTag = "<img src='" + + profileImage "'/>"; $ ('twitter # connect-comodín "). append (" Identificados como "+ + profileImageTag" ScreenName +);) else (T ("twitter # connect-marcador de posición"). ConnectButton (););)) ; </ script>

Una vez que el usuario ha autorizado la zona receptora, @ en cualquier lugar establecerá

una cookie denominada "twitter_anywhere_identity" que contiene el id del usuario

conectado. Usted puede leer esto en el lado del servidor para aprender usuario el DNI. El

formato de la cookie es:

user_id: firma

Al leer las cookies en el servidor, usted debe usar la firma para verificar que esta

información proviene de Twitter. Calcular la firma si se añade el user_id dado a tu secreto

de los consumidores y la creación de un OAuth hexagonal SHA1. Si esto coincide con la

firma en la cookie de identidad de la ID de usuario se verifica. Por ejemplo, en Ruby:

Digest:: SHA1.hexdigest (user_id consumer_secret +)

Cierre de sesión del usuario actual

Al aplicar la @ en cualquier lugar, se recomienda que proporcione el usuario actual un medio de cerrar la sesión. El twttr.anywhere.signOut () método se puede utilizar

para iniciar la sesión del usuario actual a cabo.

El siguiente ejemplo ilustra cómo crear un simple signo de botón.

<button type="button" onclick="twttr.anywhere.signOut();"> Salir de Twitter </ button>

Otro caso de uso para el isConnected y twttr.anywhere.signOut () métodos sería

mostrar condicionalmente ya sea un "Conectar con Twitter", o cerrar la sesión en función

botón en el usuario registrado en el estado.

El siguiente ejemplo ilustra cómo usar jQuery y @ en cualquier lugar para mostrar

condicionalmente ya sea un "Conectar con Twitter", o botón de cerrar la sesión en tiempo

de carga de la página.

id="login-logout"> <span </ span> <script type="text/javascript"> jQuery (function () (twttr.anywhere (función de (T) (if (T.isConnected ()) ($ ( "login #-cerrar sesión"). append ('<button id="signout" type="button"> Salir de Twitter </ button>'); $ ("# SignOut"). bind ("click", la función

Page 70: Documentacion Twitter

() (twttr.anywhere.signOut ();));) else (T ("login #-cerrar sesión"). ConnectButton ();)));)); </ script>

Aquí está el mismo ejemplo, pero usando YUI 3 y @ en cualquier lugar para mostrar

condicionalmente ya sea un "Conectar con Twitter", o botón de cerrar la sesión en tiempo

de carga de la página.

<span id="login-logout"> </ span> <script type="text/javascript"> YUI (). uso ("nodo", function (Y) (Y.on ("domready", function () (twttr.anywhere (función de (T) (if (T.isConnected)) ((Y.one ("login #-cerrar sesión"). append ('<button id="signout" type="button"> Cierra la sesión de Twitter </ button> '); Y.one ("# SignOut"). en ("click", function () (twttr.anywhere.signOut ();));) else (T ("# login-logout" ). ConnectButton ();)));));)); </ script>

Propiedades del objeto de usuario

Cuando el usuario está conectado el CurrentUser propiedad se puede utilizar para

recuperar información sobre el usuario conectado. El usuario tiene un objeto de

datos método que se puede pasar una cadena que representa la propiedad para

recuperar. La siguiente tabla proporciona una lista completa de las propiedades del objeto

de usuario.Propiedades de los objetos del usuario

Nombre Tipo

profile_background_color Cadena

descripción Cadena

profile_text_color Cadena

followers_count Número

lang Cadena

time_zone Cadena

utc_offset Número

friends_count Número

profile_link_color Cadena

statuses_count Número

created_at Cadena

siguiente Booleano

favourites_count Número

Page 71: Documentacion Twitter

Propiedades de los objetos del usuario

Nombre Tipo

profile_sidebar_fill_color Cadena

contributors_enabled Booleano

notificaciones Booleano

protegido Booleano

profile_image_url Cadena

geo_enabled Booleano

profile_background_image_url Cadena

profile_sidebar_border_color Cadena

url Cadena

ubicación Cadena

nombre Cadena

screen_name Cadena

identificación Número

verificada Booleano

profile_background_tile Booleano

Mejores PrácticasTras el user-agent "flujo" aplicación de la especificación de OAuth 2,0, después de que un

usuario se autentica a través de @ en cualquier lugar la ventana de acceso a Twitter, por

defecto, redireccionar a la dirección URL de la página que ha disparado la autenticación

con el fin de ofrecer el acceso símbolo para el navegador. Cuanto mayor sea el

anywhere.js archivo se encuentra en la página, más rápido que puede procesar el token de

acceso. (Para más información sobre OAuth 2,0 y el user-agent "flujo", léase En las

portadas de OAuth 2,0 en Facebook por Luke Shepard.)

Si bien la colocación de archivos JavaScript en la parte inferior de la página es una de las

mejores prácticas rendimiento del sitio web, al incluir el archivo anywhere.js, coloque

siempre el archivo como cerca de la parte superior de la página como sea posible. El

Page 72: Documentacion Twitter

anywhere.js archivo es pequeño (<3 KB) y se entrega a la página GZIP. Además, todas las

dependencias en cualquier lugar para @ características se cargan de forma asincrónica, a

la carta para no afectar al rendimiento de la página de acogida. Con esto en mente, haga

las llamadas a la twttr.anywhere () método en la parte inferior de la página, o

inmediatamente después de la sección de contenidos a los que una determinada función

@ en cualquier lugar hay que aplicar.

Al colocar el archivo anywhere.js en la parte inferior de la página tiene varias

implicaciones. La primera, y más simple, es el rendimiento. Desde la página de acceso de

Twitter se redirigirá a la página de que originalmente provocó la autenticación, si el archivo

es un anywhere.js la parte inferior de la página que los usuarios verán el sitio original en la

ventana emergente cuando entrada la página de acceso de Twitter vuelve a dirigir después

de que el usuario ha autenticado. La ventana emergente finalmente se cerrará una vez que

el expediente de la anywhere.js parte inferior de la página se ejecuta. Esto, por supuesto,

es una experiencia de usuario pobre como es deseable que la ventana de acceso popup

debe cerrar lo más rápidamente posible después de que el usuario se autentica.

Además de introducir el usuario experimenta problemas, colocando el archivo anywhere.js

en la parte inferior de la página incorrecta puede resultar en página de estadísticas de las

herramientas como Google Analytics. Si la página de carga completa antes de la ejecución

anywhere.js archivo a continuación, cualquier página que activa la autenticación se contará

dos veces.

Utilizando una URL de devolución de llamada personalizadosSi no es posible colocar el archivo anywhere.js en la parte superior de la página, en

cualquier lugar @ se puede configurar para que el flujo de autenticación llamada a una

URL específica. Esto puede ser sólo una página en blanco, sino que debe incluir la

anywhere.js archivo y la URL de la página debe contener el subdominio y el dominio de la

aplicación web utilizando @ en cualquier lugar.

Para especificar una devolución de llamada personalizados, simplemente URL preceder a

la llamada a twttr.anywhere con una llamada al método de configuración, pasando de un

literal de objeto con la propiedad callbackURL establece en la dirección deseada. Por

ejemplo:

type="text/javascript"> <script twttr.anywhere.config ((callbackURL: "http://www.yoursite.com/anywhere-complete")); twttr.anywhere (función de (T) (T.hovercards ( );)); <script>

Nota: La llamada a twttr.anywhere.config () debe preceder a la llamada a twttr.anywhere

(). Y la dirección de devolución de llamada debe contener el subdominio y el dominio de la

aplicación web utilizando @ en cualquier lugar.

Autorizar dominios adicionales para @ en cualquier lugarAlgunos quieren que sus ejecutores puede @ en cualquier lugar clave API para funcionar a

través de varios dominios o subdominios. De forma predeterminada, @ en cualquier lugar

sólo funcionará con el dominio especificado en la "Callback URL" campo del registro de la

aplicación.

Autorizar dominios adicionales para @ en cualquier lugar, va a comenzar sus aplicaciones,

y pulsando sobre el nombre de la aplicación en cualquier lugar @ desea configurar. A

continuación, seleccione Administrar dominios de la mano barra lateral derecha.

Page 73: Documentacion Twitter

Puede introducir hasta 5 dominios adicionales aquí, escribiendo un nombre de dominio que

desea autorizar, en el campo correspondiente y haga clic en Autorizar. Asegúrese y

autorizar únicamente los dominios en los que confíe.

Selector de ApoyoNuestro motor de selector de usos Sizzle debajo del capó. Sizzle tiene soporte para CSS

2.1, CSS 3 selectores. Consulte la documentación Sizzlepara obtener más información

sobre el soporte de selectores CSS.

Control de versionesActualmente, @ en cualquier lugar compatible con la versión 1. Las versiones posteriores

de @ en cualquier lugar puede incluir nuevas características y / o cambios que puedan ser

incompatibles con el revés en versiones anteriores.

Al declarar un número de versión, que especifica la versión como un número entero se

traducirá en cualquier lugar @ utilizando la última versión disponible para ese número de

versión principal. Por ejemplo, si la versión actual disponible en cualquier lugar de la @ es

la versión 1.2.1, que especifica una versión de un @ se traducirá en cualquier lugar

utilizando la versión 1.2.1.

También es posible utilizar en cualquier lugar @ declarando un número de versión

específica. Indicando un número de versión específica para hacer de su integración en

cualquier lugar @ permanece en una versión deseada independientemente de la última

versión disponible.

Como se menciona en la sección Introducción Obtener el número de versión se puede

especificar como un parámetro de consulta al incluir la @ en cualquier lugar del archivo

JavaScript. También es posible especificar el número de versión como el primer argumento cuando se llama allugar método. Esto hace que sea posible usar dos o más

versiones de @ en cualquier lugar al mismo tiempo.

<! DOCTYPE HTML> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title> en cualquier lugar de ejemplo </ title> <script src = " http://platform.twitter.com/anywhere.js?id=YOUR_API_KEY "type =" text / javascript "> </ script> </ head> <script type="text/javascript"> <body> twttr.anywhere ("1.2.1", function (T) (/ / Al usar la versión 1.2.1)); twttr.anywhere ("1,4", function (T) (/ / Al usar la versión 1,4)); </ script> </ cuerpo > </ html>

Orientación @ en cualquier lugar en una ventana diferenteEste método permitirá, en cualquier lugar de usar @ en una ventana diferente que no sea

la ventana principal. Por ejemplo, permitiendo @ en cualquier lugar en un iFrame

incrustado. Para configurar @ en cualquier lugar de destino a una ventana específica, pasar un objeto literal como el primer argumento de la cualquier método que especifica

la ventana deseada como el valor de la ventana de la propiedad:

type="text/javascript"> <script twttr.anywhere ((ventana: myFrame), function (T) (/ / El código aquí)); </ script>

Compatibilidad con exploradoresLa versión 1 de @ en cualquier lugar soporta los siguientes navegadores:

Page 74: Documentacion Twitter

Firefox 3.x

Chrome 4

Safari 4

Opera 10

Internet Explorer 6, 7 y 8

Tabla de contenidos ActionScript / Flash

C + +

Clojure

Coldfusion

. NET

Eiffel

Erlang

Java

Javascript

Lazo

Objective-C/Cocoa

Perl

PHP

PL / SQL

Pitón

Rubí

Scala

T-SQL

VB.NET

ActionScript / Flash TwitterScript  por Michael Galpin. AS3 API, originario de Twitter, ahora de código

abierto.

SWX API de Twitter  por los Balcanes de Aral.

Tweetr  por Sandro Duccesschi. AS3, apoya la API REST API de búsqueda, y el

acortamiento de URL.

Coderanger  por Petitt Dan. Flex / Aire OAuth biblioteca de clases.

C + + QTwitLib  por Lackey Bradley & Zolin MAKS. C + + biblioteca para Linux, Windows y

Mac. Actualmente en fase beta.

Twitcurl  por Mahesh. C + + que utiliza la colección de la biblioteca curl para la

interacción con Twitter API HTTP.

Clojure Clojure de cliente para la API de Twitter  por Matt Revele

Clojure Biblioteca para OAuth  por Matt Revele

Coldfusion twitterCOM  Michaels Quinn. Twitter Biblioteca de la Lengua CFML.

Page 75: Documentacion Twitter

CFTwitterLib  por Pedro Claudio. Twitter componentes ColdFusion API.

. NET Yedda colección de Twitter  por Yedda. Cada método de API de Twitter tiene un

equivalente. Método NET en esta biblioteca envoltura.

API TwitterooCore  por Eric Willis / RareEdge Grupo de Diseño. Binario. NET que se

puede utilizar en cualquier lenguaje. NET.

Twitterizer  originalmente por DigitallyBorn, pero ahora de código abierto. Escrito para.

NET 2.0.

TweetSharp  por Daniel Crenna. TweetSharp es una interfaz fluida a la API de Twitter

con una comunidad activa y la plena cobertura de las actuales características y

anunció API.

LINQ to Twitter  por Joe Mayo. Un proveedor de código abierto para la API de LINQ

Twitter

CSharpTwitt  por Hajariwala Himanshu. Twitter API de biblioteca en C #

TwitterVB  por Roelands Duane. Twitter API de biblioteca en VB.net

Eiffel Twitter Eiffel  por Jocelyn Fiat

Erlang erlang_twitter  por ngerakines. Un cliente de twitter Erlang.

Java Twitter4J  por Yamamoto Yusuke. Una de código abierto, mavenized y Google App

Engine segura Biblioteca de Java para la API de Twitter, publicado bajo la licencia

BSD.

java-twitter  por DeWitt Clinton. Pura interfaz java de la API de Twitter.

jtwitter  por Daniel Winterstein. De código abierto de Java pura interfaz de Twitter.

Twitter cliente  por Gist, Inc. Java cliente para conectarse a la API de streaming.

Twitter API ME  por ernandesmjr.

Javascript TwitterHelper  por Daniel Glazman

SpazCore  por Finkler Ed. Una fuente del componente de biblioteca abierta para la

construcción de escritorio y aplicaciones móviles en tiempo de ejecución web (AIR,

Titanio, WebOS). Incluye una biblioteca de Twitter.

Lazo [] Twitter  por Jason Huck.

Objective-C/Cocoa MGTwitterEngine  por Matt Gemmell. Twitter biblioteca con OAuth y apoyo xauth para

Mac OS X y el desarrollo del iPhone.

Canarias  por Toumpelis Nick. Se trata de un cliente totalmente hecha y derecha, con

apoyo a los usuarios en última m.

Page 76: Documentacion Twitter

ShareKit  es una participación de propósito general para el contenido de la colección de

Objective-C por Nate Weiner (@ IdeaShower), el apoyo a Twitter OAuth, entre otros

servicios.

Perl App:: Tweet  McAdams por Josué. Tweet en Twitter desde la línea de comandos.

Net:: Twitter  por Marc Mims. Interfaz Perl para Twitter.

:: Twitter Net:: Lite  por Marc Mims. Ligero Twitter API de la biblioteca.

Twitter:: Shell  por Maki Daisuke. Twitter desde tu shell.

PHP Mi Twitter  por Andres Scheffer. Establecer y recuperar el estado del usuario de Twitter

una.

Twitter  por Oghina Félix. Actualizar el estado de un usuario de Twitter.

TwitterLibPHP  Poliey por Justin. Manipular una cuenta de usuario de Twitter.

Arc90_Service_Twitter  por Matt Williams. El código abierto Twitter API de cliente.

PHP Twitter  por Aaron Brazell, código original de David Billingham.

PEAR Services_Twitter  por Tocón Joe y Jean Louis David.

Twitter PHP  por Tijs Verkoyen. Licencia BSD.

Twitter-async  por Jaisen Mathai. Envoltura de la API de Twitter OAuth que ofrece

llamadas asincrónicas.

API Library CodeIgniter  por Haughin Eliot.

Phirehose  por Bailey Fenn. Una biblioteca para la API de Streaming

TwitterOAuth  por Williams Abraham. La primera colección de PHP para apoyar

OAuth. MIT licencia.

oauth_twitter  por Basil Brassily Thoppil.

PL / SQL OraTweet  por Portugal Noel. Procedimientos PL / SQL para obtener línea de tiempo

amigos y actualizaciones posteriores.

Pitón OAuth-python-twitter2  por Konpaku Kogasa. Combina python-twitter y OAuth--twitter

python para crear una evolucionado OAuth Pokemon.

python-twitter  por DeWitt Clinton. Esta biblioteca proporciona una interfaz de Python

puro para la API de Twitter.

python-twyt  por Andrew Price. Licencia BSD biblioteca de interfaz API de Twitter y el

cliente de línea de comandos.

twitty-twister  por Dustin Sallings. Una interfaz de trenzado en Twitter.

twython  por Ryan McGrath. REST y la biblioteca de la búsqueda inspirada en python-

twitter.

Tweepy  por Roesslein Josh. Apoya OAuth, API de búsqueda, Streaming API.

Rubí Twitter4R  por Susan Potter. Abrir biblioteca de código Ruby para la API REST Twitter.

Twittery  Ledet por Chris. Ligero clase para la API de Twitter.

Twitter  por Nunemaker Juan. Comando twits línea y de una capa utilizando api hpricot.

Page 77: Documentacion Twitter

Grackle  por Hayes Davis. Apoya OAuth, API de búsqueda, API REST. Resistente a los

cambios de la API.

TwitterLand  por Joyce Bradley. Apoya la relacionada con las API de Twitter de

Seguimiento de Costos, Twitter Grader, el Sr. Tweet, Twinfluence y TwitterCounter.

Scala hablando-frailecillos  por Dave Briccetti.

T-SQL # SQL (SQLSharp)  por Rutzky Salomón. Una biblioteca SQLCLR de funciones y

procedimientos, algunos de ellos para Twitter.

La inclusión en la Bibliotecas Twitter no es un endoso o recomendación de estas

organizaciones en Twitter. Además, dicha inclusión no es la intención de implicar, directa o

indirectamente, que las organizaciones están de acuerdo o tienen alguna afiliación con

Twitter.

Los siguientes desarrolladores han expresado su interés en el trabajo independiente de

desarrollo de aplicaciones para la API de Twitter. Por favor, comuníquese con ellos

directamente para preguntar por su capacidad para ayudar a desarrollar una aplicación de

Twitter para sus necesidades. Tenga en cuenta que estos desarrolladores son miembros

de la comunidad y no están afiliados con Twitter en cualquier capacidad oficial.

Andy Badera

Twitter: @ andrewbadera

Énfasis en. NET y soluciones de trabajo de integración.

Nick Arnett

Twitter: @ NickArnett

URL: http://TwURLedNews.com

Mi experiencia es en la búsqueda de inteligencia de negocios en los

medios de comunicación social. Yo sobre todo usar Python y MySQL.

Abraham Williams

Twitter: @ abraham

URL: http://poseurte.chPHP, Drupal, Mi / SQL / ite, OAuth

Robert Arles

Twitter: @ metarobert

URL: http://32hours.comAutor de BeTwittered

Eric Mueller

Twitter: @ FLWbooks

URL: http://themepark.com15 + años de desarrollo web experiencia.ShortyAward 2008 Ganador de entretenimiento. Yo construí FlashlightWorthy.com, TeslaMotors.com y SmartNow.com

Daniel Crenna

Twitter: @ dimebrain

URL: http://dimebrain.com

A través de Dimebrain, desarrollo de ASP.NET (MVC), C #, Silverlight

y WPF aplicaciones aprovechando la plataforma Twitter. Yo soy el

autor de "Twitter Desarrollo Profesional"por Wrox Press, y el creador

de tweetsharp, una progresiva y popular C # twitter biblioteca.

Josh Johnson

Twitter: @ jnjosh

URL: jnjosh.comUna mezcla saludable de. NET (API de AutoCAD, ASP.NET,Aplicaciones de Windows), PHP y Cacao / CocoaTouch

Stuart Dallas

Twitter: @ stut

URL: http://3ft9.com/Desarrollé TwitApps.com, Tweetmeme.com y TwitOrFit.com.Principalmente, pero no limitado a PHP.

James Hartig

Twitter: @ fastest963

URL: http://isociale.com

Westley Annis

Twitter: @ WestleyAnnis

URL: http://www.da-parish.com

Page 78: Documentacion Twitter

PHP, MySQL, AJAX, HTML, JS PHP

Brian Gilham

Twitter: @ bgilhamPHP, MySQL, XML, Ajax, XHTML, CSS. Creador de TTCupdates.com. Localizado en Toronto, Ontario, Canadá

Adrian Invierno

Twitter: @ adrianwinter

URL: http://www.interactivepixels.nlPHP, MySQL, OAuth, XML, Ajax, XHTML, CSS, todo el lote en realidad;) Creator de TwtrFrnd.com. Lbicada en Amsterdam, Países Bajos, Europa

Daniel Winterstein

Twitter: @ Winterstein

URL: http://www.winterwell.comQue desarrollo en Java. Creador de JTwitter, una de código abierto de Java API de Twitter Biblioteca

Vinayak Joshi 

Twitter: @ Vinayak

URL: http://iilv.in/Yo trabajo principalmente con PHP. También tienen cierta experiencia en el desarrollo de chat basado en Jabber bots.

Costa Walcott

Twitter: @ dracoware

URL: http://dracoware.comComo especialista en Ruby on Rails, Grails, y el desarrollo del iPhone. Creador de tweetree.com.

Greg Raiz 

Twitter: @ graiz

URL: http://www.raizlabs.comiPhone desarrollo Twitter, Objective C y PHP. Creador de GPSTwit.com.

Rashmi Padhy Ranjan

Twitter: @ rashmiranjan

URL: jnjosh.comPHP, MySQL y otros. Creador de tgrps.com.

Pavlo Zahozhenko

Twitter: @ pavlozahozhenko

URL: http://comindwork.comRuby on Rails, y. Net. Creador de la integración-Comindwork Twitter. Situado en Kiev, Ucrania.

Jonathan Markwell

Twitter: @ JonMarkwell

URL: http://inuda.comRuby on Rails. Fundador de la jerarquía de desarrolladores de Twitter. Creador de SocialPlume y CommunityTweet. Ubicado en el Reino Unido.

Gary C.

Twitter: @ garyc_guru

URL: http://www.compgurus.netPHP, CFML, JS, SQL, Python

Elia Morling

Twitter: @ tribalingswe

URL: http://twitter.tribaling.comFlash, PHP, XML, JS, SQL

Cristóbal San Juan

Twitter: @ cks

URL: http://artofsystems.blogspot.comHaskell / :-) Cacao. Creador de twasker, un código abierto Haskell Twitter API de la biblioteca.

Lucas Araujo

Twitter: @ lucasaraujo

URL: http://code.google.com/u/araujo.lucas/PHP, AS3

Brian Deterling

Twitter: @ bdeter

URL: http://signalsready.comCreador de http://tweepdiff.com

Nic Rosental

Twitter: @ nicdev

URL: http://loft119.com

Lakshman Prasad

Twitter: @ scorpion032

URL: http://uswaretech.com

Craig Mason

Twitter: @ CraigMason

URL: http://www.stasismedia.com

Aaron Brazell

Twitter: @ technosailor

URL: http://emmense.com

Pete Warden

Twitter: @ petewarden

Dave Briccetti

Twitter: @ dcbriccetti

URL: http://davebsoft.com

Page 79: Documentacion Twitter

URL: http://twitter.mailana.com/

Burhan Tanweer

Twitter: @ explorewww

URL: http://explorewww.co

Karthik Murugan

Twitter: @ yemkay

URL: http://yemkay.elance.com

Scott C. Limón

Twitter: @ Humancell

URL: http://www.humanxtensions.com

La experiencia en la creación de una amplia gama de

redes sociales y twitter

aplicaciones. Los creadores

dehttp://www.TopFollowFriday.com

Kiruba Shankar

Twitter: @ kdots

Farez Rahman

Twitter: @ Farez

URL: redkeydigital.comIndependientes de desarrolladores de PHP con base en Shoreditch, Londres. Tener experiencia en el desarrollo y la integración con Twitter Drupal o CakePHP. También interesado en la creación de aplicaciones móviles.

David Neubauer

Twitter: @ DavidNeubauer

Creador de nutshellmail.com

Sean Payne

Twitter: @ twobile

URL: http://www.infinitumsoftware.com/twobile

C # en dispositivos Windows Mobile. Creador de Twobile.

Liam Gladdy

Twitter: @ lgladdy

URL: http://www.gladdymedia.com

AJAX / Web especializadas, PHP, MySQL.

Josh Carrico

Twitter: @ SIGEPJEDI

URL: http://JoshCarrico.comColdFusion, JSON, MS SQL, MySQL, Fusebox marco. 12 + años de experiencia. Creador de tweepletwak.com, toptweeple.com, sqlputdowns.com. Ubicado en Tampa, Florida.

Nick Toumpelis

Twitter: @ macsphere

URL: http://www.canaryapp.comIndependientes, desarrollador con experiencia en Objective-C, Cocoa, Java y NET.

Ollie Perejil

Twitter: @ ollieparsley

URL: http://ollieparsley.com

Independientes de desarrolladores de PHP con

experiencia en PHP / MySQL, Oracle y .NET /. Creador de

footytweets.com, twitterleague.com y

h1debate.com. Situado en Dorset, Reino Unido.

Mike Matz

Twitter: @ pix0r

URL: http://pixor.net/

En gran escala con PHP aplicaciones web, software de iPhone.

Gajapati Subudhi

Twitter: @ gajsubudhi

URL:http://www.newageinformationmarketing.com

Matthew Arnold

Twitter: @ mattarnold1977

URL: http://www.mattsblogsite.com

ASP.NET, Javascript, AJAX, SQL. Creador de populartweets.com.

Sharjeel Ahmed

Twitter: @ Sharj

URL: http://www.sharjeel.info

Ruby on Rails, PHP.

Jay Tillery

Twitter: @ jtillery

URL: http://netondas.com

PHP, MySQL, Javascript, CSS, HTML

Page 80: Documentacion Twitter

Arnaud Coomans

Twitter: @ acoomans

URL: www.commentag.com, www.tweetag.com

PHP, MySQL, CSS, Ajax, Perl, Python

Marcos Ng,

Twitter: @ markng

URL: http://www.markng.co.ukPython, Django, HTML, CSS, JS. Creador de twitfave.com

M. Edward (Ed) Borasky

Twitter: @ znmeb

URL: http://www.linkedin.com/in/edboraskyR, Ruby, Perl

Mark Mason

Twitter: @ pushwork

URL: http://pushwork.com

OS400, CL, y el acceso a twitter PASE de IBM iSeries y AS400s, la

integración de alerta por nuevos o existentes sistemas evento en

Twitter.

Joe Mayo

Twitter: @ JoeMayo

URL: http://www.mayosoftware.com/

. NET, creador de linqtotwitter.codeplex.com, Autor de C

# 3.0 Unleashed y Programación LINQ

Doug Pfeffer

Twitter: @ pfeffunit

correo electrónico: Gmail doug.pfeffer <at>

Ruby on Rails, PHP, MySQL, Objective-C, Cocoa. Creador de

rappersontwitter.com y mytwitterweighsaton.com.

Jacob Saxberg

Twitter: @ Webjay

URL: http://webcom.dk

Syed Mazhar Hasan

Twitter: @ mazharhasan

Flash, Flex, AS3, ASP.Net y PHP

Kyle Blanco

Twitter: @ Vector_Kyle

URL: http://www.techlogica.us

ActionScript 3, C, C #, PHP, SQL, serialización XML, icono /

Interfaz / Diseño Web. Creador de Twitteron.

Justin Poliey

Twitter: @ justinpoliey

URL: http://justinpoliey.com

Creador de twitterlibphp

Yong Kim Su

URL: http://www.hanperson.com

Correo electrónico: [email protected]

Creador de TwitIQ.com y TwitHive.com.

10to1

Twitter: @ tomklaasen y atog

URL: http://10to1.be, http://twistory.net, http://twiddict.com

Ruby on Rails

Michael Collins

Twitter: @ GUICenter

URL: http://twurlednews.com/

Web 2.0 Arquitecto con 10 + años de experiencia. PHP,

Python, Perl, JavaScript, jQuery, Dojo, Sql.

Jim Renkel

Twitter: @ jim_renkel

Correo electrónico: [email protected]

Creador de http://twxlate.com

Más de 40 años de experiencia, experto en Java, C + +, HTML, SQL,

XML,

JSON, Ajax, etc, y se encuentra cerca de Chicago, IL, EE.UU.

Arnaud Meunier

Twitter: @ twitoaster

E-mail: [en contacto con [twitoaster] punto] com

URL: http://twitoaster.com

PHP, MySQL, Javascript / AJAX, y la administración de

Linux Debian

Johannes la Poutre

Twitter: @ jlapoutre

URL: http://squio.nl/

Aplicaciones a Twitter, por ejemplo Augmented Reality aplicación

"tweeps Aroound" para Layar

Josh Fraser

Twitter: @ joshfraser

Álvaro Garrido

Twitter: @ garretus

Page 81: Documentacion Twitter

URL: http://www.onlineaspect.com/

PHP, MySQL, AJAX, OAuth

URL: http://www.garretus.com

PHP, SQL, JavaScript, ActionScript 3, Flash, Flex.

años de trabajo con las API social, con sede en Madrid.

Yvo Schaap

Twitter: @ yvoschaap

URL: http://www.yvoschaap.com

Con experiencia en la aplicación, manejo y análisis de

Streaming API de Twitter.

 

La inclusión en el Desarrolladores para el alquiler no es un endoso o recomendación de

estas organizaciones en Twitter. Además, dicha inclusión no es la intención de implicar,

directa o indirectamente, que las organizaciones están de acuerdo o tienen alguna

afiliación con Twitter.