> ## Documentation Index > Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # 연동 가이드 > 게시물 조회 연동을 위한 핵심 개념과 모범 사례 export const Button = ({href, children}) => { return

; }; 이 가이드에서는 애플리케이션에 게시물 조회 엔드포인트를 통합하는 데 필요한 핵심 개념을 다룹니다. ***

## 인증

### App-Only authentication

공개 게시물 데이터를 조회할 때는 Bearer 토큰을 사용합니다: ```bash cURL theme={null} curl "https://api.x.com/2/tweets/1234567890" \ -H "Authorization: Bearer $BEARER_TOKEN" ``` ```python Python SDK theme={null} from xdk import Client client = Client(bearer_token="YOUR_BEARER_TOKEN") # ID로 단일 게시물을 조회합니다 response = client.posts.get("1234567890") print(response.data) ``` ```javascript JavaScript SDK theme={null} import { Client } from "@xdevplatform/xdk"; const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" }); const response = await client.posts.get("1234567890"); console.log(response.data); ```

### User Context 인증

비공개 메트릭에 접근하려면 게시물 작성자를 대신하여 인증해야 합니다. 다음 필드에는 User Context 인증이 필요합니다: * `tweet.fields.non_public_metrics` * `tweet.fields.promoted_metrics` * `tweet.fields.organic_metrics` * `media.fields.non_public_metrics` * `media.fields.promoted_metrics` * `media.fields.organic_metrics` ***

## 필드와 expansions

X API v2는 기본적으로 최소한의 데이터만 반환합니다. 정확히 필요한 데이터만 요청하려면 `fields`와 `expansions`를 사용하세요.

### 기본 응답

```json theme={null} { "data": { "id": "1234567890", "text": "Hello world!", "edit_history_tweet_ids": ["1234567890"] } } ```

### 사용 가능한 필드

### 필드가 포함된 예시

```bash cURL theme={null} curl "https://api.x.com/2/tweets/1234567890?\ tweet.fields=created_at,public_metrics,entities&\ expansions=author_id,attachments.media_keys&\ user.fields=username,verified&\ media.fields=url,type" \ -H "Authorization: Bearer $BEARER_TOKEN" ``` ```python Python SDK theme={null} from xdk import Client client = Client(bearer_token="YOUR_BEARER_TOKEN") # 추가 필드와 expansions가 포함된 게시물 가져오기 response = client.posts.get( "1234567890", tweet_fields=["created_at", "public_metrics", "entities"], expansions=["author_id", "attachments.media_keys"], user_fields=["username", "verified"], media_fields=["url", "type"] ) print(response.data) print(response.includes) # 확장된 사용자 및 미디어 객체를 포함 ``` ```javascript JavaScript SDK theme={null} import { Client } from "@xdevplatform/xdk"; const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" }); const response = await client.posts.get("1234567890", { tweetFields: ["created_at", "public_metrics", "entities"], expansions: ["author_id", "attachments.media_keys"], userFields: ["username", "verified"], mediaFields: ["url", "type"], }); console.log(response.data); console.log(response.includes); // 확장된 사용자 및 미디어 객체를 포함 ``` ***

## 게시물 수정

게시물은 작성 후 30분 이내에 최대 5번까지 수정할 수 있습니다.

### 작동 방식

* 각 편집 시 새로운 게시물 ID가 생성됩니다 * `edit_history_tweet_ids`에는 모든 버전이 포함되며, 가장 오래된 것부터 나열됩니다 * 이 엔드포인트에서는 항상 최신 버전을 반환합니다

### 응답 예시

```json theme={null} { "data": { "id": "1234567893", "text": "Hello world! (edited twice)", "edit_history_tweet_ids": [ "1234567890", "1234567891", "1234567893" ] } } ``` 30분짜리 편집 가능 시간이 지난 뒤에 조회된 포스트는 최종 버전입니다. 실시간 사용 사례에서는 최근에 게시된 포스트가 아직 수정 중일 수 있다는 점에 유의하세요. ***

## 오류 처리

### 일반적인 오류

### 삭제되었거나 보호된 포스트

게시물이 삭제되었거나, 사용자가 팔로우하지 않는 보호된 계정의 게시물인 경우: * 단일 게시물 조회에서는 `404`를 반환합니다. * 다중 게시물 조회에서는 결과에서 해당 게시물을 제외하고 `errors` 배열을 포함합니다. ```json theme={null} { "data": [ { "id": "1234567890", "text": "Available post" } ], "errors": [ { "resource_id": "1234567891", "resource_type": "tweet", "title": "Not Found Error", "detail": "Could not find tweet with id: [1234567891]." } ] } ``` ***

## 모범 사례

multi-Post endpoint를 사용해 한 번에 최대 100개의 게시물을 가져와 API 호출을 줄이세요. 응답 크기와 처리 시간을 최소화하기 위해 필요한 필드만 지정하세요. 동일한 콘텐츠에 대한 반복 요청을 줄이기 위해 게시물 데이터를 로컬에 캐싱하세요. 실시간 앱의 경우 30분 편집 가능 시간이 지난 후에 게시물을 다시 조회하는 것을 고려하세요. ***

## 다음 단계

완전한 엔드포인트 문서 사용 가능한 모든 객체와 필드 동작하는 코드 예제 오류를 안정적으로 처리하는 방법