유용한 도구
Postman
코드 예제
서드파티 라이브러리
핵심 개념
인증
개발자 콘솔, 프로젝트, 그리고 개발자 App
요청 한도
| Endpoint | HTTP method | Rate limit |
|---|---|---|
| /2/users/:id/pinned_lists | POST | 15분당 50회 요청 |
| /2/users/:id/pinned_lists/:list_id | DELETE | 15분당 50회 요청 |
| /2/users/:id/pinned_lists | GET | 15분당 15회 요청 |
필드와 expansions
fields 및 expansions라고 불리는 도구 집합을 통해 API에서 어떤 데이터를 반환할지 정확하게 선택할 수 있습니다. expansions 매개변수를 사용하면 페이로드에서 참조된 객체를 확장해 실제 객체로 포함할 수 있습니다. 예를 들어, 고정된 리스트를 조회하면 다음과 같은 expansions을 가져올 수 있습니다:
owner_id
fields 매개변수를 사용하면 서로 다른 데이터 객체 안에서 어떤 fields를 받을지 정확히 선택할 수 있습니다. 이 엔드포인트는 주로 User 객체를 반환합니다. 기본적으로 리스트 객체는 id 및 name 필드를 반환합니다. list.created_at 또는 list.description과 같은 추가 필드를 받으려면, 해당 필드를 fields 매개변수로 명시적으로 요청해야 합니다.
X API v2 data dictionary에 fields and expansions를 함께 사용하는 방법에 대한 가이드를 추가했습니다.
아래 표는 조회 엔드포인트에서 사용할 수 있는 필드와 expansions를 보여줍니다:
| Endpoint | Fields | Expansions |
|---|---|---|
| /2/users/:id/pinned_lists | list.fields, user.fields | owner_id |