Een basisverbinding maken

Een basisverbinding geeft de bron aan en bevat de informatie die nodig is om de stroom compatibel te maken met streaming opname-API's. Wanneer u een basisverbinding maakt, kunt u een niet-geverifieerde en een geverifieerde verbinding maken.

Niet-geverifieerde verbinding

Niet-geverifieerde verbindingen zijn de standaardstreamingverbindingen die u kunt maken wanneer u gegevens wilt streamen naar Experience Platform.

Als u een niet-geverifieerde basisverbinding wilt maken, vraagt u een POST-aanvraag naar het eindpunt van /connections en geeft u een naam op voor uw verbinding, het gegevenstype en de specificatie-id van de HTTP-API-verbinding. Deze id is bc7b00d6-623a-4dfc-9fdb-f1240aeadaeb .

API formaat

POST /flowservice/connections

Verzoek

Met de volgende aanvraag wordt een basisverbinding voor de HTTP-API gemaakt.

curl -X POST https://platform.adobe.io/data/foundation/flowservice/connections \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "name": "ACME Streaming Connection XDM Data",
    "description": "ACME streaming connection for customer data",
    "connectionSpec": {
        "id": "bc7b00d6-623a-4dfc-9fdb-f1240aeadaeb",
        "version": "1.0"
    },
    "auth": {
      "specName": "Streaming Connection",
      "params": {
        "dataType": "xdm"
      }
    }
  }'
curl -X POST https://platform.adobe.io/data/foundation/flowservice/connections \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '{
    "name": "ACME Streaming Connection Raw Data",
    "description": "ACME streaming connection for customer data",
    "connectionSpec": {
        "id": "bc7b00d6-623a-4dfc-9fdb-f1240aeadaeb",
        "version": "1.0"
    },
    "auth": {
      "specName": "Streaming Connection",
      "params": {
        "dataType": "raw"
      }
    }
  }'
EigenschapBeschrijving
nameDe naam van uw basisverbinding. Zorg ervoor dat de naam beschrijvend is aangezien u dit kunt gebruiken om op informatie over uw basisverbinding te zoeken.
description(Optioneel) Een eigenschap die u kunt opnemen voor meer informatie over de basisverbinding.
connectionSpec.idDe verbindingsspecificatie-id die overeenkomt met HTTP API. Deze id is bc7b00d6-623a-4dfc-9fdb-f1240aeadaeb .
auth.params.dataTypeHet gegevenstype voor de streamingverbinding. Tot de ondersteunde waarden behoren: xdm en raw .
auth.params.nameDe naam van de streamingverbinding die u wilt maken.

Reactie

Een succesvolle reactie keert status 201 van HTTP met details van de pas gecreëerde verbinding, met inbegrip van zijn uniek herkenningsteken (id) terug.

{
  "id": "a59d368a-1152-4673-a46e-bd52e8cdb9a9",
  "etag": "\"f50185ed-0000-0200-0000-637e8fad0000\""
}
EigenschapBeschrijving
idDe id van de nieuwe basisverbinding.
etagEen id die is toegewezen aan de verbinding en die de versie van de basisverbinding opgeeft.