데이터 객체 목록 조회

이 엔드포인트를 사용하면 특정 데이터 객체 유형의 객체 목록을 조회할 수 있습니다.

중요

데이터 객체는 정식 출시되었지만, 이 엔드포인트를 사용하려면 먼저 워크스페이스에 계정(Accounts)이 프로비저닝되어 있어야 합니다. 프로비저닝을 요청하려면 데이터 설정 > 계정으로 이동하여 설문지를 작성하세요. 자세한 내용은 계정 활성화를 참조하세요.

전제 조건

이 엔드포인트를 사용하려면 data_objects.read 권한이 있는 API 키가 필요합니다.

사용량 제한

이 엔드포인트는 데이터 객체 읽기 버킷에 속하며, 기본 사용량 제한은 분당 1,000건의 요청입니다.

경로 매개변수

다음 표에서는 /data_objects/objects/{type_name} 엔드포인트의 경로 매개변수를 나열하고 설명합니다.

쿼리 매개변수

다음 표에서는 /data_objects/objects/{type_name} 엔드포인트의 쿼리 매개변수를 나열하고 설명합니다.

요청 예시

이 섹션에서는 샘플 매개변수 페이로드와 샘플 cURL 요청을 제공합니다.

샘플 요청 페이로드

다음 JSON 객체를 요청 매개변수의 참고용으로 사용하세요.

1
2
3
4
5
6

{
  "type_name": "account",
  "search_term": "acct",
  "limit": 100,
  "offset": 0
}

샘플 cURL 요청

이 예시에서는 검색어 acct와 일치하는 account 레코드를 조회하여 결과의 첫 번째 페이지를 반환합니다.

1
2

curl --location --request GET 'https://rest.iad-01.braze.com/data_objects/objects/account?search_term=acct&limit=100&offset=0' \
--header 'Authorization: Bearer YOUR_REST_API_KEY'

응답

이 섹션에서는 성공 응답 예시와 응답 필드를 설명합니다.

성공 응답 예시

상태 코드 200은 다음과 같은 응답 본문을 반환할 수 있습니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14

{
  "items": [
    {
      "type_name": "account",
      "object_id": "acct-123",
      "attributes": { "name": "Acme", "industry": "software" }
    }
  ],
  "total_count": 1,
  "has_more": false,
  "next_offset": null,
  "offset": 0,
  "limit": 100
}

응답 매개변수

다음 표에서는 성공 응답에 포함된 필드를 나열하고 설명합니다.

오류

다음 표에서는 이 엔드포인트에서 자주 발생하는 오류와 해결 방법을 나열합니다.