Skip to content

카탈로그 선택 항목 만들기

post

/catalogs/{catalog_name}/selections

이 엔드포인트를 사용하여 카탈로그에서 선택 항목을 생성합니다.

필수 조건

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

사용량 제한

이 엔드포인트는 API 속도 제한 설명서에 명시된 바와 같이, 모든 비동기 카탈로그 필드 및 선택 엔드포인트 간에 분당 50개의 요청이라는 공유 속도 제한을 적용받습니다.

경로 매개변수

요청 매개변수

선택 개체 매개변수

요청 예시

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

curl --location --request POST 'https://rest.iad-03.braze.com/catalogs/restaurants/selections' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR-REST-API-KEY' \
--data-raw '{
  "selection": {
    "name": "favorite-restaurants",
    "description": "Favorite restaurants in NYC",
    "external_id": "favorite-nyc-restaurants",
    "source": "custom",
    "filters": [
      {
        "field": "City",
        "operator": "equals",
        "value": "NYC"
      },
      {
        "field": "Rating",
        "operator": "greater than",
        "value": 7
      }
    ],
    "results_limit": 10,
    "sort_field": "Rating",
    "sort_order": "desc"
  }
}'

필터 연산자

Response

이 엔드포인트에 대한 상태 코드 응답은 202, 400, 404 의 세 가지가 있습니다 .

성공 응답의 예

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

1
2
3

{
  "message": "success"
}

오류 응답의 예

400 상태 코드는 다음과 같은 응답 본문을 반환할 수 있습니다. 발생할 수 있는 오류에 대한 자세한 내용은 문제 해결을 참조하세요.

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

{
  "errors": [
    {
      "id": "catalog-not-found",
      "message": "Could not find catalog",
      "parameters": [
        "catalog_name"
      ],
      "parameter_values": [
        "restaurants"
      ]
    }
  ],
  "message": "Invalid Request"
}

문제 해결

다음 표에는 가능한 반환 오류와 관련된 문제 해결 단계가 나와 있습니다.
Github   GitHub 에서 이 페이지를 편집합니다.
New Stuff!