Guia rápido

Este guia mostra como criar, atualizar e excluir Lists.

Pré-requisitosAntes de começar, você precisará de:

Uma conta de desenvolvedor com um App aprovado
User Access Token (OAuth 1.0a ou OAuth 2.0 PKCE)

Criar uma List

Prepare sua requisição

Defina o nome da List (obrigatório) e a descrição e configurações de privacidade opcionais:

{
  "name": "Tech News",
  "description": "Top tech journalists and publications",
  "private": false
}

Envie a requisição

cURL

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News",
    "description": "Top tech journalists and publications",
    "private": false
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Criar uma nova List
response = client.lists.create(
    name="Tech News",
    description="Top tech journalists and publications",
    private=False
)

print(f"List created: {response.data.id} - {response.data.name}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Criar uma nova List
const response = await client.lists.create({
  name: "Tech News",
  description: "Top tech journalists and publications",
  private: false,
});

console.log(`List created: ${response.data?.id} - ${response.data?.name}`);

Revise a resposta

{
  "data": {
    "id": "1441162269824405510",
    "name": "Tech News"
  }
}

Guarde o id para atualizar ou excluir a List depois.

Atualizar uma List

Modifique o nome, a descrição ou a privacidade de uma List:

cURL

curl -X PUT "https://api.x.com/2/lists/1441162269824405510" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News & Insights",
    "description": "Updated description"
  }'

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Atualizar uma List
response = client.lists.update(
    "1441162269824405510",
    name="Tech News & Insights",
    description="Updated description"
)

print(f"Updated: {response.data.updated}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Atualizar uma List
const response = await client.lists.update("1441162269824405510", {
  name: "Tech News & Insights",
  description: "Updated description",
});

console.log(`Updated: ${response.data?.updated}`);

Resposta:

{
  "data": {
    "updated": true
  }
}

Excluir uma List

Obtenha o ID da List

Você precisa do ID da List que deseja excluir.

Envie a requisição de exclusão

cURL

curl -X DELETE "https://api.x.com/2/lists/1441162269824405510" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# Excluir uma List
response = client.lists.delete("1441162269824405510")
print(f"Deleted: {response.data.deleted}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// Excluir uma List
const response = await client.lists.delete("1441162269824405510");
console.log(`Deleted: ${response.data?.deleted}`);

Confirme a exclusão

{
  "data": {
    "deleted": true
  }
}

Você só pode excluir Lists das quais é proprietário.

Próximos passos

Membros da List

Adicione e remova membros da List

Consulta de List

Recupere detalhes da List

Guia de integração

Conceitos-chave e melhores práticas

Referência da API

Documentação completa do endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Guia rápido

Criar uma List

Atualizar uma List

Excluir uma List

Próximos passos

Membros da List

Consulta de List

Guia de integração

Referência da API

​Criar uma List

​Atualizar uma List

​Excluir uma List

​Próximos passos

Membros da List

Consulta de List

Guia de integração

Referência da API

Criar uma List

Atualizar uma List

Excluir uma List

Próximos passos