Aggiornare gli account utilizzando l’API del servizio Flusso
In alcuni casi, potrebbe essere necessario aggiornare i dettagli di una connessione sorgente esistente. Flow Service consente di aggiungere, modificare ed eliminare i dettagli di una connessione batch o streaming esistente, inclusi nome, descrizione e credenziali.
Questo tutorial illustra i passaggi necessari per aggiornare i dettagli e le credenziali di una connessione tramite Flow Service API.
Introduzione
Questo tutorial richiede una connessione esistente e un ID connessione valido. Se non si dispone di una connessione esistente, selezionare l'origine desiderata tra panoramica sulle origini e segui i passaggi descritti prima di provare questa esercitazione.
Questo tutorial richiede anche una buona conoscenza dei seguenti componenti di Adobe Experience Platform:
- Sorgenti: un Experience Platform consente di acquisire dati da varie origini, consentendoti allo stesso tempo di strutturare, etichettare e migliorare i dati in arrivo tramite i servizi di Platform.
- Sandbox: Experience Platform fornisce sandbox virtuali che permettono di suddividere una singola istanza Platform in ambienti virtuali separati, utili per le attività di sviluppo e aggiornamento delle applicazioni di esperienza digitale.
Utilizzo delle API di Platform
Per informazioni su come effettuare correttamente chiamate alle API di Platform, consulta la guida su introduzione alle API di Platform.
Cerca dettagli di connessione
Il primo passaggio nell’aggiornamento della connessione consiste nel recuperarne i dettagli utilizzando il tuo ID connessione. Per recuperare i dettagli correnti della connessione, effettua una richiesta GET al Flow Service fornendo l’ID della connessione della connessione da aggiornare.
Formato API
GET /connections/{CONNECTION_ID}
{CONNECTION_ID}
id
valore per la connessione che si desidera recuperare.Richiesta
La richiesta seguente recupera informazioni relative alla connessione.
curl -X GET \
'https://platform.adobe.io/data/foundation/flowservice/connections/139f6a5f-a78b-4744-9f6a-5fa78bd74431' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Risposta
In caso di esito positivo, la risposta restituisce i dettagli correnti della connessione, incluse le credenziali, l’identificatore univoco (id
) e versione. Per aggiornare la connessione è necessario il valore della versione.
{
"items": [
{
"createdAt": 1597973312000,
"updatedAt": 1597973312000,
"createdBy": "{CREATED_BY}",
"updatedBy": "{UPDATED_BY}",
"createdClient": "{CREATED_CLIENT}",
"updatedClient": "{UPDATED_CLIENT}",
"sandboxName": "{SANDBOX_NAME}",
"id": "139f6a5f-a78b-4744-9f6a-5fa78bd74431",
"name": "E2E_SF Base_Connection",
"connectionSpec": {
"id": "cfc0fee1-7dc0-40ef-b73e-d8b134c436f5",
"version": "1.0"
},
"state": "enabled",
"auth": {
"specName": "Basic Authentication",
"params": {
"securityToken": "{SECURITY_TOKEN}",
"password": "{PASSWORD}",
"username": "my-salesforce-account",
"environmentUrl": "login.salesforce.com"
}
},
"version": "\"1400dd53-0000-0200-0000-5f3f23450000\"",
"etag": "\"1400dd53-0000-0200-0000-5f3f23450000\""
}
]
}
Aggiorna connessione
Per aggiornare il nome, la descrizione e le credenziali della connessione, esegui una richiesta PATCH al Flow Service fornendo l’ID della connessione, la versione e le nuove informazioni che desideri utilizzare.
If-Match
L’intestazione è obbligatoria quando si effettua una richiesta PATCH. Il valore di questa intestazione è la versione univoca della connessione che desideri aggiornare.Formato API
PATCH /connections/{CONNECTION_ID}
{CONNECTION_ID}
id
valore per la connessione da aggiornare.Richiesta
La richiesta seguente fornisce un nuovo nome e una nuova descrizione, nonché un nuovo set di credenziali, con cui aggiornare la connessione.
curl -X PATCH \
'https://platform.adobe.io/data/foundation/flowservice/connections/139f6a5f-a78b-4744-9f6a-5fa78bd74431' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
-H 'If-Match: 1400dd53-0000-0200-0000-5f3f23450000' \
-d '[
{
"op": "replace",
"path": "/auth/params",
"value": {
"username": "salesforce-connector-username",
"password": "{NEW_PASSWORD}",
"securityToken": "{NEW_SECURITY_TOKEN}"
}
},
{
"op": "replace",
"path": "/name",
"value": "Test salesforce connection"
},
{
"op": "add",
"path": "/description",
"value": "A test salesforce connection"
}
]'
op
add
, replace
, e remove
.path
value
Risposta
In caso di esito positivo, la risposta restituisce l’ID di connessione e un tag aggiornato. Per verificare l’aggiornamento, effettua una richiesta GET al Flow Service e fornire l'ID di connessione.
{
"id": "139f6a5f-a78b-4744-9f6a-5fa78bd74431",
"etag": "\"3600e378-0000-0200-0000-5f40212f0000\""
}
Passaggi successivi
Seguendo questa esercitazione, hai aggiornato le credenziali e le informazioni associate alla connessione utilizzando Flow Service API. Per ulteriori informazioni sull'utilizzo dei connettori di origine, vedere panoramica sulle origini.