모든 v2 엔드포인트는 일관된 패턴을 따릅니다.
동일한 fields 및 expansions 매개변수를 일관되게 사용할 수 있습니다:
동일한 객체 type은 어떤 endpoint에서 반환되더라도 동일한 필드를 가집니다.
- search에서 가져온 게시물은 lookup에서 가져온 게시물과 동일한 필드를 가집니다.
- followers에서 가져온 User는 search에서 가져온 User와 동일한 필드를 가집니다.
- 확장된 객체는 해당 객체를 단독으로 조회했을 때와 동일한 형태입니다.
모든 엔드포인트에서 다음과 같은 인증 방식을 사용합니다:
errors 필드는 일관된 형식을 따릅니다:
모든 페이지네이션 지원 엔드포인트는 동일한 토큰 시스템을 사용합니다:
페이지네이션에 대해 더 알아보기 →
- 미국식 영어 철자 사용 (
favorites, notfavourites) - 필드 이름에는 snake_case 사용 (
author_id,created_at) - 용어 일관성 유지 (필드에서는
repost_count가 아니라retweet_count사용)
값이 없는 필드는
null로 반환되지 않고 생략됩니다:
entities 객체에는 텍스트를 파싱해 추출한 엔티티만 포함합니다:
urlshashtagsmentionscashtags
entities가 아니라 attachments에 있습니다.
한 번 배우면 어디서나 활용
한 엔드포인트에서 익힌 패턴을 모든 엔드포인트에 적용할 수 있습니다.
예측 가능한 응답
동일한 객체 type은 API 전체에서 동일한 구조를 가집니다.
더 단순한 코드
공통 패턴을 위한 재사용 가능한 함수를 작성할 수 있습니다.
더 쉬운 디버깅
일관된 오류 형식으로 문제 해결이 더 쉬워집니다.
불일치 사항을 발견하셨나요? 아래 채널을 통해 알려 주세요: