앱 구성 끝점

경고

의 구현 /app_configurations 기능이 추가, 제거 및 재작동하므로 엔드포인트는 플럭스입니다.

앱 구성을 사용하면 자격 증명을 저장하고 나중에 사용할 수 있습니다. 다음 /app_configurations reactor API의 종단점을 사용하면 experience 애플리케이션 내에서 앱 구성을 프로그래밍 방식으로 관리할 수 있습니다.

시작하기

이 안내서에 사용된 엔드포인트는 Reactor API. 계속하기 전에 시작 안내서 를 참조하십시오.

앱 구성 목록 검색

API 형식

GET /companies/{COMPANY_ID}/app_configurations

매개 변수	설명
`COMPANY_ID`	다음 `id` 의 회사 앱 구성을 소유합니다.

노트

쿼리 매개 변수를 사용하여 나열된 앱 구성을 다음 속성에 따라 필터링할 수 있습니다.

app_id
created_at
key_type
messaging_service
name
platform
updated_at

다음 안내서를 참조하십시오. 응답 필터링 추가 정보.

요청

curl -X GET \
  https://reactor.adobe.io/companies/COdb0cd64ad4524440be94b8496416ec7d/app_configurations \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1'

응답

성공적인 응답이 앱 구성 목록을 반환합니다.

{
  "data": [
    {
      "id": "AC40c339ab80d24c958b90d67b698602eb",
      "type": "app_configurations",
      "attributes": {
        "created_at": "2020-12-14T17:31:10.626Z",
        "updated_at": "2020-12-14T17:31:10.626Z",
        "app_id": "com.adobe.test_app",
        "name": "Kessel Apns App",
        "platform": "mobile",
        "messaging_service": "apns",
        "key_type": "p8_file"
      },
      "relationships": {
        "company": {
          "links": {
            "related": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company"
          },
          "data": {
            "id": "CO2bf094214ffd4785bb4bcf88c952a7c1",
            "type": "companies"
          }
        }
      },
      "links": {
        "company": "https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1",
        "self": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb"
      }
    }
  ],
  "meta": {
    "pagination": {
      "current_page": 1,
      "next_page": null,
      "prev_page": null,
      "total_pages": 1,
      "total_count": 1
    }
  }
}

앱 구성 조회

GET 요청 경로에 해당 ID를 제공하여 앱 구성을 조회할 수 있습니다.

API 형식

GET /app_configurations/{APP_CONFIGURATION_ID}

매개 변수	설명
`APP_CONFIGURATION_ID`	다음 `id` 조회하려는 앱 구성 중에서 하나를 선택합니다.

요청

curl -X GET \
  https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1'

응답

성공적인 응답은 앱 구성의 세부 사항을 반환합니다.

{
  "data": {
    "id": "AC40c339ab80d24c958b90d67b698602eb",
    "type": "app_configurations",
    "attributes": {
      "created_at": "2020-12-14T17:31:10.626Z",
      "updated_at": "2020-12-14T17:31:10.626Z",
      "app_id": "com.adobe.test_app",
      "name": "Kessel Apns App",
      "platform": "mobile",
      "messaging_service": "apns",
      "key_type": "p8_file"
    },
    "relationships": {
      "company": {
        "links": {
          "related": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company"
        },
        "data": {
          "id": "CO2bf094214ffd4785bb4bcf88c952a7c1",
          "type": "companies"
        }
      }
    },
    "links": {
      "company": "https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1",
      "self": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb"
    }
  }
}

앱 구성 만들기

POST 요청을 만들어 새 앱 구성을 만들 수 있습니다.

API 형식

POST /companies/{COMPANY_ID}/app_configurations

매개 변수	설명
`COMPANY_ID`	다음 `id` 의 회사 아래에 앱 구성을 정의합니다.

요청

curl -X POST \
  https://reactor.adobe.io/companies \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "attributes": {
            "name": "Kessel Apns App",
            "app_id": "com.adobe.test_app",
            "platform": "mobile",
            "messaging_service": "apns",
            "key_type": "p8_file",
            "push_credential": {
              "bundleId": "com.adobe.test_app",
              "keyId": "{KEY_ID}",
              "p8": "{SECRET}",
              "teamId": "{TEAM_ID}"
            }
          },
          "type": "app_configurations"
        }
      }'

속성	설명
`platform`	애플리케이션이 실행되는 플랫폼(웹 또는 모바일)입니다. 사용 가능한 메시징 서비스를 결정합니다.
`messaging_service`	앱과 연결된 메시징 서비스(예: ) Apple 푸시 알림 서비스(APNs) 및 Firebase Cloud Messaging(FCM). 이것은 사용할 수 있는 키 유형을 결정합니다.
`key_type`	푸시 서비스 공급업체가 지원하는 프로토콜을 나타내며, `push_credential` 개체. 메시징 서비스에 대한 프로토콜이 발전함에 따라, `key_type` 업데이트된 프로토콜을 지원하기 위해 값이 만들어집니다.
`push_credential`	실제 자격 증명 값(나머지 위치에서 암호화됨)입니다. 이 필드는 일반적으로 해독되거나 API 응답에 포함되지 않습니다. 특정 Adobe 서비스만 해독된 푸시 자격 증명이 포함된 응답을 받을 수 있습니다.

응답

성공적으로 응답하면 새로 만든 앱 구성의 세부 사항이 반환됩니다.

{
  "data": {
    "id": "AC40c339ab80d24c958b90d67b698602eb",
    "type": "app_configurations",
    "attributes": {
      "created_at": "2020-12-14T17:31:10.626Z",
      "updated_at": "2020-12-14T17:31:10.626Z",
      "app_id": "com.adobe.test_app",
      "name": "Kessel Apns App",
      "platform": "mobile",
      "messaging_service": "apns",
      "key_type": "p8_file"
    },
    "relationships": {
      "company": {
        "links": {
          "related": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company"
        },
        "data": {
          "id": "CO2bf094214ffd4785bb4bcf88c952a7c1",
          "type": "companies"
        }
      }
    },
    "links": {
      "company": "https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1",
      "self": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb"
    }
  }
}

앱 구성 업데이트

PATCH 요청 경로에 해당 ID를 포함하여 앱 구성을 업데이트할 수 있습니다.

API 형식

PATCH /app_configurations/{APP_CONFIGURATION_ID}

매개 변수	설명
`APP_CONFIGURATION_ID`	다음 `id` 업데이트할 앱 구성 중 하나를 선택합니다.

요청

다음 요청은 를 업데이트합니다 app_id 기존 앱 구성에 대해 설명합니다.

curl -X PATCH \
  https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "attributes": {
            "app_id": "com.adobe.test_app_2"
          },
          "id": "AC40c339ab80d24c958b90d67b698602eb",
          "type": "app_configurations"
        }
      }'

속성	설명
`attributes`	속성이 앱 구성에 대해 업데이트할 속성을 나타내는 개체입니다. 각 키는 업데이트할 특정 앱 구성 속성과 함께 업데이트해야 하는 해당 값을 나타냅니다. 앱 구성에 대해 다음 속성을 업데이트할 수 있습니다. `app_id` `key_type` `messaging_service` `name` `platform` `push_credential`
`id`	다음 `id` 업데이트할 앱 구성 중 하나를 선택합니다. 이 옵션은 와 일치해야 합니다. `{APP_CONFIGURATION_ID}` 요청 경로에 제공된 값입니다.
`type`	업데이트할 리소스 유형입니다. 이 끝점의 경우 값은 `app_configurations`.

응답

성공적인 응답은 업데이트된 앱 구성의 세부 정보를 반환합니다.

{
  "data": {
    "id": "AC40c339ab80d24c958b90d67b698602eb",
    "type": "app_configurations",
    "attributes": {
      "created_at": "2020-12-14T17:31:10.626Z",
      "updated_at": "2020-12-14T17:31:21.787Z",
      "app_id": "com.adobe.test_app_2",
      "name": "Kessel Apns App",
      "platform": "mobile",
      "messaging_service": "apns",
      "key_type": "p8_file"
    },
    "relationships": {
      "company": {
        "links": {
          "related": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb/company"
        },
        "data": {
          "id": "CO2bf094214ffd4785bb4bcf88c952a7c1",
          "type": "companies"
        }
      }
    },
    "links": {
      "company": "https://reactor.adobe.io/companies/CO2bf094214ffd4785bb4bcf88c952a7c1",
      "self": "https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb"
    }
  }
}

앱 구성 삭제

DELETE 요청 경로에 해당 ID를 포함하여 앱 구성을 삭제할 수 있습니다.

API 형식

DELETE /app_configurations/{APP_CONFIGURATION_ID}

매개 변수	설명
`APP_CONFIGURATION_ID`	다음 `id` 삭제할 앱 구성 중에서 하나를 선택합니다.

요청

curl -X DELETE \
  https://reactor.adobe.io/app_configurations/AC40c339ab80d24c958b90d67b698602eb \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1'

응답

성공적으로 응답하면 앱 구성이 삭제되었음을 나타내는 응답 본문이 없는 HTTP 상태 204(콘텐츠 없음)를 반환합니다.

새로운 검색, 검색 기능 개선

앱 구성 끝점

시작하기

앱 구성 목록 검색

앱 구성 조회

앱 구성 만들기

앱 구성 업데이트

앱 구성 삭제

Business.Adobe.com 리소스

이 페이지에서는

다음 보기:

학습

기술 문서

커뮤니티

고객지원

리소스

Adobe 계정

Adobe