Hämta en målserverkonfiguration
Den här sidan innehåller exempel på API-begäran och nyttolast som du kan använda för att hämta information om en befintlig målserverkonfiguration med /authoring/destination-servers
API-slutpunkt.
En detaljerad beskrivning av de funktioner som används av målservrar finns i följande artiklar:
Komma igång med API-åtgärder för målserver get-started
Innan du fortsätter bör du granska komma igång-guide för viktig information som du behöver känna till för att kunna anropa API:t, inklusive hur du får nödvändig behörighet för målredigering och obligatoriska huvuden.
Hämta en målserverkonfiguration retrieve
Du kan hämta en befintlig målserverkonfiguration genom att skapa en GET
begäran till /authoring/destination-servers
slutpunkt.
platform.adobe.io/data/core/activation/authoring/destination-servers
API-format
Använd följande API-format för att hämta alla målserverkonfigurationer för ditt konto.
GET /authoring/destination-servers
Använd följande API-format för att hämta en specifik målserverkonfiguration, som definieras av {INSTANCE_ID}
parameter.
GET /authoring/destination-servers/{INSTANCE_ID}
Följande två begäranden hämtar alla målserverkonfigurationer för din IMS-organisation, eller en viss målserverkonfiguration, beroende på om du skickar INSTANCE_ID
-parametern i begäran.
Välj varje flik nedan för att visa motsvarande nyttolast och deras svar.
Följande begäran hämtar listan över målserverkonfigurationer som du har åtkomst till, baserat på IMS Org ID och sandlådekonfiguration.
accordion | ||
---|---|---|
Begäran | ||
|
accordion | ||
---|---|---|
svar | ||
Ett lyckat svar returnerar HTTP-status 200 med en lista över målserverkonfigurationer som du har åtkomst till, baserat på IMS Org ID och namnet på sandlådan som du använde. Ett
|
Följande begäran hämtar en specifik målserverkonfiguration som definieras av {INSTANCE_ID}
parameter.
accordion | ||||||||
---|---|---|---|---|---|---|---|---|
Begäran | ||||||||
|
accordion | ||
---|---|---|
svar | ||
Ett lyckat svar returnerar HTTP-status 200 med målserverns konfiguration som motsvarar
|
API-felhantering error-handling
Destination SDK-API-slutpunkter följer de allmänna felmeddelandeprinciperna för Experience Platform API. Se API-statuskoder och fel i begäranhuvudet i felsökningsguiden för plattformen.
Nästa steg next-steps
När du har läst det här dokumentet kan du nu hämta en målserverkonfiguration via Destinationen SDK /authoring/destination-servers
API-slutpunkt.
Mer information om vad du kan göra med den här slutpunkten finns i följande artiklar: