Werken met de API voor uitsnijden work
Met de API voor uitsnijden kunt u uw configuraties voor uitlijnen maken, configureren en controleren.
Beschrijving van API voor uitlijnen
{uid}
/implementatie{uid}
/uninstall{uid}
/canDeploy{uid}
{uid}
{uid}
Wanneer een configuratie wordt gecreeerd of bijgewerkt, automatisch wordt een controle uitgevoerd om de syntaxis en de integriteit van de lading te waarborgen.
Als sommige problemen voorkomen, keert de verrichting waarschuwing of fouten terug om u te helpen de configuratie verbeteren.
Eindpuntconfiguratie
Hier is de basisstructuur van een eindpuntconfiguratie:
{
"url": "<endpoint URL>", //wildcards are allowed in the endpoint URL
"methods": [ "<HTTP method such as GET, POST, >, ...],
"services": {
"<service name>": { . //must be "action" or "dataSource"
"maxHttpConnections": <max connections count to the endpoint (optional)>
"rating": {
"maxCallsCount": <max calls to be performed in the period defined by period/timeUnit>,
"periodInMs": <integer value greater than 0>
}
},
...
}
}
Voorbeeld:
`{
"url": "https://api.example.org/data/2.5/*",
"methods": [
"GET"
],
"services": {
"dataSource": {
"maxHttpConnections": 50,
"rating": {
"maxCallsCount": 500,
"periodInMs": 1000
}
}
},
"orgId": "<IMS Org Id>"
}
Waarschuwing en fouten
Wanneer een canDeploy De methode wordt geroepen, bevestigt het proces de configuratie en keert de bevestigingsstatus terug die door zijn Unieke identiteitskaart wordt geïdentificeerd, of:
"ok" or "error"
De mogelijke fouten zijn:
- ERR_ENDPOINTCONFIG_100: configuratie beperken: ontbrekende of ongeldige URL
- ERR_ENDPOINTCONFIG_101: config.capping: onjuist gevormde URL
- ERR_ENDPOINTCONFIG_102: config.capping: onjuist gevormde url: wildchar in url niet toegestaan in host:port
- ERR_ENDPOINTCONFIG_103: config.capping: ontbrekende HTTP-methoden
- ERR_ENDPOINTCONFIG_104: het maximum config: geen bepaalde vraagclassificatie
- ERR_ENDPOINTCONFIG_107: het in kaart brengen config: ongeldige maximumvraagtelling (maxCallsCount)
- ERR_ENDPOINTCONFIG_108: het in kaart brengen config: ongeldige maximum vraagtelling (periodInMS)
- ERR_ENDPOINTCONFIG_111: het begrenzen config: kan geen eindpunt config tot stand brengen: ongeldige lading
- ERR_ENDPOINTCONFIG_112: het begrenzen config: kan geen eindpunt config tot stand brengen: het verwachten van een JSON nuttige lading
- ERR_AUTHORING_ENDPOINTCONFIG_1: ongeldige servicenaam
<!--<given value>-->
: moet 'dataSource' of 'action' zijn
De mogelijke waarschuwing is:
ERR_ENDPOINTCONFIG_106: config.max. HTTP-verbindingen niet gedefinieerd: standaard geen beperking
Gebruiksscenario's
In deze sectie zult u de vijf belangrijkste gebruik-gevallen vinden die u kunt uitvoeren om uw het capteren configuratie binnen te beheren Journey Orchestration.
Voor hulp bij het testen en configureren is hier een Postman-verzameling beschikbaar.
Deze Postman-verzameling is opgezet om de Postman Variabele verzameling te delen die is gegenereerd via Adobe I/O Console-integraties > Uitproberen > Downloaden voor Postman, wat een Postman-omgevingsbestand genereert met de geselecteerde integratiewaarden.
Eenmaal gedownload en geüpload naar Postman moet u drie variabelen toevoegen: {JO_HOST}
,{BASE_PATH}
en {SANDBOX_NAME}
.
{JO_HOST}
: Journey Orchestration Gateway-URL{BASE_PATH}
: ingangspunt voor de API. De waarde is '/authoring'{SANDBOX_NAME}
: de header x-sandbox-name (bijvoorbeeld 'prod') die overeenkomt met de sandboxnaam waar de API-operaties zullen plaatsvinden. Zie het sandboxoverzicht voor meer informatie.
In het volgende gedeelte vindt u de geordende lijst van Rest-API-aanroepen om het gebruiksscenario uit te voeren.
Gebruiksscenario n°1: Het creëren en de plaatsing van een nieuwe het maximum configuratie
- list
- create
- candeploy
- deploy
Gebruiksscenario n°2: Een configuratie voor uitlijnen bijwerken en implementeren die nog niet is geïmplementeerd
- list
- get
- update
- candeploy
- deploy
Gebruiksscenario n°3: Implementeer en verwijder een geïmplementeerde configuratie voor plafonnering
- list
- undeploy
- delete
Gebruiksscenario n°4: Verwijder een configuratie voor geïmplementeerde uiteinden.
In slechts één API-oproep kunt u de configuratie deïmplementeren en verwijderen met behulp van de parameter forceDelete.
- list
- delete, met parameter forceDelete
Gebruiksscenario n°5: Een reeds geïmplementeerde configuratie voor plafonnering bijwerken
- list
- get
- update
- undeploy
- candeploy
- deploy