Saltar al contenido principal
X está comprometido con nuestra comunidad de desarrolladores que crean con la X API. Como parte de este compromiso, nuestro objetivo es que nuestra API sea abierta y justa para los desarrolladores, segura para las personas en X y beneficiosa para la plataforma X en su conjunto. Es crucial que cualquier desarrollador que almacene contenido de X sin conexión se asegure de que los datos reflejen la intención del usuario y el estado actual del contenido en X. Por ejemplo, cuando alguien en X elimina un Post o su cuenta, protege sus Posts o elimina la información de geolocalización de sus Posts, es fundamental tanto para X como para nuestros desarrolladores respetar las expectativas e intención de esa persona. Los endpoints de cumplimiento por lotes proporcionan a los desarrolladores una herramienta sencilla para ayudar a mantener los datos de X en conformidad con el X Developer Agreement and Policy.  Estos endpoints de cumplimiento por lotes te permiten cargar grandes conjuntos de datos de IDs de Post o de usuario para recuperar su estado de cumplimiento y determinar qué datos requieren acción para poner tus conjuntos de datos en conformidad. Ten en cuenta que el uso de los endpoints de cumplimiento por lotes está restringido a los casos de uso antes mencionados, y cualquier otro propósito está prohibido y puede dar lugar a medidas de aplicación. Normalmente, hay 4 pasos para trabajar con este endpoint:
  1. Crear un trabajo de cumplimiento Puedes especificar el tipo de trabajo (con el valor tweets o users) para indicar si el conjunto de datos que deseas cargar contiene IDs de Post o IDs de usuario. Puedes tener un trabajo concurrente por tipo de trabajo en cualquier momento.
  2. Cargar tu conjunto de datos en el upload_url A continuación, cargas tu conjunto de datos como un archivo de texto plano en el upload_url proporcionado, con cada línea del archivo que contenga un único ID de Post o ID de usuario. El upload_url vence a los 15 minutos.
  3. (Opcional) Verificar el estado del trabajo Puedes consultar el estado de tu trabajo de cumplimiento para ver si está created, in_progress, failed o complete.
  4. Descargar los resultados Cuando tu trabajo esté completo, puedes descargar los resultados usando el download_url. El download_url vence a la semana (desde la creación del trabajo). Este resultado contendrá un conjunto de objetos JSON (un objeto por línea). Cada objeto contendrá un ID de Post, la fecha de creación del Post (útil para localizar Posts organizados por fecha), la acción requerida, el motivo de la acción de cumplimiento y la fecha en que el usuario fue suspendido.
Recibirás los siguientes tipos de eventos de cumplimiento en tus resultados:
  • deleted - indica que el Post o la cuenta de usuario fue eliminado
  • deactivated - indica que el Post o la cuenta de usuario ha sido desactivado
  • scrub_geo - indica que se eliminó la información de geolocalización asociada con el Post o el usuario
  • protected - indica que la cuenta que hizo el Post pasó a ser privada
  • suspended - indica que la cuenta que hizo el Post fue suspendida
Configuración de la cuenta Para acceder a estos endpoints, necesitarás: Obtén más información sobre cómo obtener acceso a los endpoints de la X API v2 en nuestra getting started guide.