> ## Documentation Index
> Fetch the complete documentation index at: https://docs.x.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de integração

> Esta página cobre ferramentas e conceitos-chave para integrar os endpoints de Lists fixadas. Referência para o nível standard da X API v2 sobre pinned lists.

export const Button = ({href, children}) => {
  return <div className="not-prose">
    <a href={href}>
      <button className="x-btn">
        <span>{children}</span>
        <svg width="3" height="24" viewBox="0 -9 3 24" class="h-6 rotate-0 overflow-visible"><path d="M0 0L3 3L0 6" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round"></path></svg>
      </button>
    </a>
  </div>;
};

Esta página cobre ferramentas e conceitos-chave para integrar os endpoints de Lists fixadas.

## Ferramentas úteis

Antes de mergulharmos em alguns conceitos-chave que irão ajudar você a integrar este endpoint, recomendamos que você se familiarize com:

### Postman

Postman é uma ótima ferramenta que você pode usar para testar um endpoint. Cada requisição do Postman inclui todos os parâmetros de caminho e de corpo para ajudá-lo a entender rapidamente o que está disponível. Para saber mais sobre nossas coleções do Postman, visite nossa página ["Usando o Postman"](/tutorials/postman-getting-started).

### Exemplos de código

Interessado em começar a usar este endpoint com código na sua linguagem de programação preferida? Temos vários exemplos de código diferentes que você pode usar como ponto de partida na nossa [página do Github](https://github.com/xdevplatform/Twitter-API-v2-sample-code).

### Bibliotecas de terceiros

Aproveite uma das [bibliotecas de terceiros](/tools-and-libraries) da nossa comunidade para ajudar você a começar. Você pode encontrar uma biblioteca que funcione com os endpoints v2 procurando pela tag de versão correta.

***

## Conceitos-chave

### Autenticação

Todos os endpoints da X API v2 exigem que você autentique suas requisições com um conjunto de credenciais, também conhecidas como chaves e tokens. Você pode usar OAuth 1.0a User Context para autenticar suas requisições neste endpoint.

[OAuth 1.0a User Context](/resources/fundamentals/authentication), o que significa que você deve usar um conjunto de API Keys e user Access Tokens para fazer uma requisição bem-sucedida. Os access tokens devem estar associados ao usuário em nome de quem você está fazendo a requisição. Se quiser gerar um conjunto de Access Tokens para outro usuário, ele deve autorizar seu App usando o [fluxo 3-legged OAuth](https://developer.x.com/resources/fundamentals/authentication/obtaining-user-access-tokens).

Observe que o OAuth 1.0a pode ser difícil de usar. Se você não estiver familiarizado com esse método de autenticação, recomendamos que use uma [biblioteca](/tools-and-libraries) ou uma ferramenta como o Postman.

### Developer Console, Projects e developer Apps

Para obter um conjunto de credenciais de autenticação que funcione com os endpoints da X API v2, você precisa [criar uma conta de desenvolvedor](https://developer.x.com/en/portal/petition/essential/basic-info), configurar um [Project](/resources/fundamentals/developer-apps) dentro dessa conta e criar um [App de desenvolvedor](/resources/fundamentals/developer-apps) dentro desse Project. Você poderá então encontrar suas chaves e tokens dentro do seu App de desenvolvedor.

### Rate limits

Todos os dias, milhares de desenvolvedores fazem requisições à X API. Para ajudar a gerenciar o grande volume dessas requisições, [rate limits](/x-api/fundamentals/rate-limits) são aplicados a cada endpoint, limitando o número de requisições que você pode fazer em nome do seu app ou em nome de um usuário autenticado.

Esses endpoints têm rate limit no nível do usuário, o que significa que o usuário autenticado em nome de quem você está fazendo a requisição só pode chamar o endpoint um certo número de vezes em qualquer App de desenvolvedor.

A tabela abaixo mostra os rate limits para cada endpoint.

| Endpoint                             | Método HTTP | Rate limit                    |
| :----------------------------------- | :---------- | :---------------------------- |
| /2/users/:id/pinned\_lists           | POST        | 50 requisições por 15 minutos |
| /2/users/:id/pinned\_lists/:list\_id | DELETE      | 50 requisições por 15 minutos |
| /2/users/:id/pinned\_lists           | GET         | 15 requisições por 15 minutos |

### Fields e expansions

O endpoint GET da X API v2 permite que os usuários selecionem exatamente quais dados desejam que sejam retornados da API usando um conjunto de ferramentas chamado `fields` e `expansions`. O parâmetro `expansions` permite expandir objetos referenciados no payload. Por exemplo, ao consultar Lists fixadas, você pode obter as seguintes [expansions](/x-api/fundamentals/expansions):

* `owner_id`

O parâmetro `fields` permite selecionar exatamente quais [fields](/x-api/fundamentals/fields) dentro dos diferentes objetos de dados você deseja receber. Este endpoint entrega principalmente objetos de usuário. Por padrão, o objeto List retorna os fields `id` e `name`. Para receber fields adicionais como `list.created_at` ou `list.description`, você terá que solicitá-los especificamente usando um parâmetro fields.

Adicionamos ao nosso [dicionário de dados da X API v2](/x-api/fundamentals/data-dictionary) um guia sobre como usar [fields e expansions](/x-api/fundamentals/data-dictionary/reference#how-to-use-fields-and-expansions) em conjunto.

A tabela abaixo mostra os fields e expansions disponíveis para o endpoint de consulta:

| Endpoint                   | Fields                       | Expansions |
| :------------------------- | :--------------------------- | :--------- |
| /2/users/:id/pinned\_lists | `list.fields`, `user.fields` | `owner_id` |