Slutpunkt för appkonfigurationer

WARNING
Genomförandet av /app_configurations slutpunkten ändras när funktioner läggs till, tas bort och omarbetas.

Appkonfigurationer tillåter att autentiseringsuppgifter lagras och hämtas för senare bruk. The /app_configurations -slutpunkten i Reaktors API gör att du kan hantera appkonfigurationer inom ditt upplevelseprogram programmatiskt.

Komma igång

Slutpunkten som används i den här guiden är en del av Reaktors-API. Läs igenom komma igång-guide om du vill ha viktig information om hur du autentiserar till API:t.

Hämta en lista med appkonfigurationer list

API-format

GET /companies/{COMPANY_ID}/app_configurations
Parameter
Beskrivning
COMPANY_ID
The id i företag som äger appkonfigurationerna.
NOTE
Med hjälp av frågeparametrar kan listade appkonfigurationer filtreras baserat på följande attribut:
  • app_id
  • created_at
  • key_type
  • messaging_service
  • name
  • platform
  • updated_at
filtrera svar

Begäran

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'

Svar

Ett lyckat svar returnerar en lista med appkonfigurationer.

{
  "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
    }
  }
}

Söka efter en appkonfiguration lookup

Du kan söka efter en appkonfiguration genom att ange dess ID i sökvägen till en GET-begäran.

API-format

GET /app_configurations/{APP_CONFIGURATION_ID}
Parameter
Beskrivning
APP_CONFIGURATION_ID
The id för den programkonfiguration som du vill söka efter.

Begäran

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'

Svar

Ett lyckat svar returnerar information om appkonfigurationen.

{
  "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"
    }
  }
}

Skapa en appkonfiguration create

Du kan skapa en ny programkonfiguration genom att göra en POST-förfrågan.

API-format

POST /companies/{COMPANY_ID}/app_configurations
Parameter
Beskrivning
COMPANY_ID
The id i företag som du definierar appkonfigurationen under.

Begäran

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"
        }
      }'
Egenskap
Beskrivning
platform
Plattformen som programmet körs på (webb eller mobil). Detta avgör vilka meddelandetjänster som är tillgängliga.
messaging_service
Meddelandetjänsten som är kopplad till appen, till exempel Apple Push Notification service (APN:er) och Firebase Cloud Messaging (FCM). Detta avgör vilka nyckeltyper som kan användas.
key_type
Representerar det protokoll som en push-tjänstleverantör stöder och fastställer formatet för push_credential -objekt. I takt med att protokollen utvecklas för meddelandetjänster finns det nya key_type -värden skapas som stöd för de uppdaterade protokollen.
push_credential
Det faktiska autentiseringsvärdet, som är krypterat i vila. Det här fältet dekrypteras vanligtvis inte eller inkluderas i API-svar. Endast vissa Adobe-tjänster kan få ett svar som innehåller en dekrypterad push-autentiseringsuppgift.

Svar

Ett lyckat svar returnerar information om den nya appkonfigurationen.

{
  "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"
    }
  }
}

Uppdatera en appkonfiguration

Du kan uppdatera en programkonfiguration genom att inkludera dess ID i sökvägen för en PATCH-begäran.

API-format

PATCH /app_configurations/{APP_CONFIGURATION_ID}
Parameter
Beskrivning
APP_CONFIGURATION_ID
The id för den programkonfiguration som du vill uppdatera.

Begäran

Följande begäran uppdaterar app_id för en befintlig programkonfiguration.

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"
        }
      }'
Egenskap
Beskrivning
attributes

Ett objekt vars egenskaper representerar attributen som ska uppdateras för appkonfigurationen. Varje nyckel representerar det specifika programkonfigurationsattribut som ska uppdateras, tillsammans med motsvarande värde som det ska uppdateras till.

Följande attribut kan uppdateras för appkonfigurationer:

  • app_id
  • key_type
  • messaging_service
  • name
  • platform
  • push_credential
id
The id för den programkonfiguration som du vill uppdatera. Det här bör matcha {APP_CONFIGURATION_ID} värdet som anges i sökvägen för begäran.
type
Den typ av resurs som uppdateras. För den här slutpunkten måste värdet vara app_configurations.

Svar

Ett lyckat svar returnerar information om den uppdaterade programkonfigurationen.

{
  "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"
    }
  }
}

Ta bort en appkonfiguration

Du kan ta bort en programkonfiguration genom att ta med dess ID i sökvägen för en DELETE-begäran.

API-format

DELETE /app_configurations/{APP_CONFIGURATION_ID}
Parameter
Beskrivning
APP_CONFIGURATION_ID
The id för den programkonfiguration som du vill ta bort.

Begäran

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'

Svar

Ett lyckat svar returnerar HTTP-status 204 (inget innehåll) utan svarstext, vilket anger att appkonfigurationen har tagits bort.

recommendation-more-help
12b4e4a9-5028-4d88-8ce6-64a580811743