Recuperare una richiesta di pubblicazione di destinazione

IMPORTANT
Devi utilizzare questo endpoint API solo se invii una destinazione prodotta (pubblica), che dovrà essere utilizzata da altri clienti Experience Platform. Se crei una destinazione privata per uso personale, non è necessario inviare formalmente la destinazione utilizzando l’API di pubblicazione.
IMPORTANT
Endpoint API: platform.adobe.io/data/core/activation/authoring/destinations/publish

Dopo aver configurato e testato la destinazione, puoi inviarla ad Adobe per la revisione e la pubblicazione. Leggi Invia per rivedere una destinazione creata in Destination SDK per tutti gli altri passaggi da eseguire durante il processo di invio della destinazione.

Utilizza l’endpoint API per la pubblicazione delle destinazioni per inviare una richiesta di pubblicazione quando:

  • In qualità di partner di Destination SDK, desideri rendere la tua destinazione prodotta disponibile in tutte le organizzazioni di Experienci Platform per tutti i clienti di Experienci Platform da utilizzare;
  • Hai apportato qualsiasi aggiornamento alle tue configurazioni. Gli aggiornamenti della configurazione vengono rispecchiati nella destinazione solo dopo l’invio di una nuova richiesta di pubblicazione, approvata dal team di Experienci Platform.
IMPORTANT
Tutti i nomi e i valori dei parametri supportati da Destination SDK sono con distinzione tra maiuscole e minuscole. Per evitare errori di distinzione tra maiuscole e minuscole, utilizza i nomi e i valori dei parametri esattamente come mostrato nella documentazione.

Guida introduttiva alle operazioni API di pubblicazione di destinazione get-started

Prima di continuare, consulta la guida introduttiva per informazioni importanti che devi conoscere per effettuare correttamente chiamate all'API, tra cui come ottenere l'autorizzazione di authoring della destinazione richiesta e le intestazioni richieste.

Elencare richieste di pubblicazione di destinazione retrieve-list

Per recuperare un elenco di tutte le destinazioni inviate per la pubblicazione per la tua organizzazione IMS, effettua una richiesta di GET all'endpoint /authoring/destinations/publish.

Formato API

Utilizza il seguente formato API per recuperare tutte le richieste di pubblicazione per il tuo account.

GET /authoring/destinations/publish

Utilizzare il seguente formato API per recuperare una richiesta di pubblicazione specifica, definita dal parametro {DESTINATION_ID}.

GET /authoring/destinations/publish/{DESTINATION_ID}

Richiesta

Le due richieste seguenti recuperano tutte le richieste di pubblicazione per l’organizzazione IMS o una richiesta di pubblicazione specifica, a seconda che si trasmetta o meno il parametro DESTINATION_ID nella richiesta.

Seleziona ciascuna scheda di seguito per visualizzare il payload corrispondente.

Recupera tutte le richieste di pubblicazione
accordion
Richiesta

La richiesta seguente recupererà l'elenco delle richieste di pubblicazione inviate, in base a IMS Org ID e alla configurazione sandbox.

code language-shell
curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations/publish \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
accordion
Risposta

La risposta che segue restituisce lo stato HTTP 200 con un elenco di tutte le destinazioni inviate per la pubblicazione a cui hai accesso, in base all’ID organizzazione IMS e al nome della sandbox utilizzati. Un configId corrisponde alla richiesta di pubblicazione per una destinazione.

code language-json
{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "publishDetailsList":[
      {
         "configId":"ab41387c0-4772-4709-a3ce-6d5fee654520",
         "allowedOrgs":[
            "716543205DB85F7F0A495E5B@AdobeOrg"
         ],
         "status":"TEST",
         "destinationType":"DEV"
      },
      {
         "configId":"cd568c67-f25e-47e4-b9a2-d79297a20b27",
         "allowedOrgs":[
            "*"
         ],
         "status":"DEPRECATED",
         "destinationType":"PUBLIC",
         "publishedDate":1630525501009
      },
      {
         "configId":"ef6f07154-09bc-4bee-8baf-828ea9c92fba",
         "allowedOrgs":[
            "*"
         ],
         "status":"PUBLISHED",
         "destinationType":"PUBLIC",
         "publishedDate":1630531586002
      }
   ]
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Parametro Tipo Descrizione
destinationId Stringa ID di destinazione della configurazione di destinazione inviata per la pubblicazione.
publishDetailsList.configId Stringa ID univoco della richiesta di pubblicazione di destinazione per la destinazione inviata.
publishDetailsList.allowedOrgs Stringa

Restituisce le organizzazioni di Experience Platform per le quali è disponibile la destinazione.

  • Per "destinationType": "PUBLIC", questo parametro restituisce "*", il che significa che la destinazione è disponibile per tutte le organizzazioni Experience Platform.
  • Per "destinationType": "DEV", questo parametro restituisce l'ID organizzazione dell'organizzazione utilizzata per l'authoring e il test della destinazione.
publishDetailsList.status Stringa Lo stato della richiesta di pubblicazione di destinazione. I valori possibili sono TEST, REVIEW, APPROVED, PUBLISHED, DENIED, REVOKED, DEPRECATED. Le destinazioni con il valore PUBLISHED sono live e possono essere utilizzate dai clienti Experience Platform.
publishDetailsList.destinationType Stringa Il tipo di destinazione. I valori possono essere DEV e PUBLIC. DEV corrisponde alla destinazione nell'organizzazione Experience Platform. PUBLIC corrisponde alla destinazione inviata per la pubblicazione. Considera queste due opzioni in termini Git, dove la versione DEV rappresenta il ramo di authoring locale e la versione PUBLIC rappresenta il ramo principale remoto.
publishDetailsList.publishedDate Stringa La data in cui la destinazione è stata inviata per la pubblicazione, in tempo reale.
Recuperare una richiesta di pubblicazione specifica
accordion
Richiesta
code language-shell
curl -X GET https://platform.adobe.io/data/core/activation/authoring/destinations/publish/{DESTINATION_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}'
table 0-row-2 1-row-2
Parametro Descrizione
{DESTINATION_ID} ID della destinazione per la quale desideri recuperare lo stato di pubblicazione.
accordion
Risposta

Se hai passato un DESTINATION_ID nella chiamata API, la risposta restituisce lo stato HTTP 200 con informazioni dettagliate sulla richiesta di pubblicazione della destinazione specificata.

code language-json
{
   "destinationId":"1230e5e4-4ab8-4655-ae1e-a6296b30f2ec",
   "publishDetailsList":[
      {
         "configId":"123cs780-ce29-434f-921e-4ed6ec2a6c35",
         "allowedOrgs": [
            "*"
         ],
         "status":"PUBLISHED",
         "destinationType": "PUBLIC",
         "publishedDate":"1630617746"
      }
   ]
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 layout-auto
Parametro Tipo Descrizione
destinationId Stringa ID di destinazione della configurazione di destinazione inviata per la pubblicazione.
publishDetailsList.configId Stringa ID univoco della richiesta di pubblicazione di destinazione per la destinazione inviata.
publishDetailsList.allowedOrgs Stringa

Restituisce le organizzazioni di Experience Platform per le quali è disponibile la destinazione.

  • Per "destinationType": "PUBLIC", questo parametro restituisce "*", il che significa che la destinazione è disponibile per tutte le organizzazioni Experience Platform.
  • Per "destinationType": "DEV", questo parametro restituisce l'ID organizzazione dell'organizzazione utilizzata per l'authoring e il test della destinazione.
publishDetailsList.status Stringa Lo stato della richiesta di pubblicazione di destinazione. I valori possibili sono TEST, REVIEW, APPROVED, PUBLISHED, DENIED, REVOKED, DEPRECATED. Le destinazioni con il valore PUBLISHED sono live e possono essere utilizzate dai clienti Experience Platform.
publishDetailsList.destinationType Stringa Il tipo di destinazione. I valori possono essere DEV e PUBLIC. DEV corrisponde alla destinazione nell'organizzazione Experience Platform. PUBLIC corrisponde alla destinazione inviata per la pubblicazione. Considera queste due opzioni in termini Git, dove la versione DEV rappresenta il ramo di authoring locale e la versione PUBLIC rappresenta il ramo principale remoto.
publishDetailsList.publishedDate Stringa La data in cui la destinazione è stata inviata per la pubblicazione, in tempo reale.

Gestione degli errori API

Gli endpoint API di Destination SDK seguono i principi generali dei messaggi di errore API di Experience Platform. Consulta Codici di stato API e errori di intestazione della richiesta nella guida alla risoluzione dei problemi di Platform.

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6