Work with the Capping API work

The Capping API helps you create, configure and monitor your capping configurations.

This section provides global information on how to work with the API. A detailed API description is available in Adobe Journey Optimizer APIs documentation.

Capping API description & Postman collection description

The table below lists the available commands for the capping API. Detailed information including request samples, parameters, and response formats is available in the Adobe Journey Optimizer APIs documentation.

Methode
Path
Beschrijving
POST
list/endpointConfigs
Get a list of the endpoint capping configurations
POST
/endpointConfigs
Create an endpoint capping configuration
POST
/endpointConfigs/{uid}/deploy
Deploy an endpoint capping configuration
POST
/endpointConfigs/{uid}/undeploy
Undeploy an endpoint capping configuration
POST
/endConfigs/{uid}/canDeploy
Controle als een eindpunt het begrenzen configuratie kan worden opgesteld of niet
PUT
/endConfigs/{uid}
Een configuratie voor het afdekken van eindpunten bijwerken
GET
/endConfigs/{uid}
Retrireer een eindpunt dat configuratie begrenst
DELETE
/endConfigs/{uid}
Een configuratie voor een uitlijningselement verwijderen

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.

Bovendien is een inzameling van Postman beschikbaar ​ hier ​ om u in uw het testen configuratie te helpen.

Deze inzameling is opstelling geweest om de Variabele die inzameling van Postman te delen via de Integraties van de Console van Adobe I/O wordt geproduceerd ​ > probeert het uit > Download voor Postman, die een dossier van het Milieu van Postman met de geselecteerde integratiewaarden produceert.

Nadat u het bestand hebt gedownload en geüpload naar Postman, moet u drie variabelen toevoegen: {JO_HOST} , {BASE_PATH} en {SANDBOX_NAME} .

  • {JO_HOST} : Journey Optimizer URL van gateway.
  • {BASE_PATH} : ingangspunt voor de API.
  • {SANDBOX_NAME} : de kopbal x-zandbak-naam (bijvoorbeeld, “prod”) die aan de zandbaknaam beantwoordt waar de API verrichtingen zullen plaatsvinden. Zie het ​ zandbakenoverzicht ​ voor meer informatie.

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>
            }
        },
        ...
    }
}
IMPORTANT
De maxHttpConnections parameter is facultatief. Zo kunt u het aantal verbindingen beperken dat Journey Optimizer opent voor het externe systeem.
De maximale waarde die kan worden ingesteld, is 400. Als niets wordt gespecificeerd, dan kan het systeem tot veelvoudige duizenden verbindingen afhankelijk van het dynamische schrapen van het systeem openen.
Wanneer de configuratie voor plafonnering wordt geïmplementeerd, als er geen maxHttpConnections -waarde is ingesteld, wordt een standaardwaarde maxHttpConnections = -1 toegevoegd aan de configuratie die wordt geïmplementeerd en gebruikt Journey Optimizer de standaardwaarde van het systeem.

Voorbeeld:

{
  "url": "https://api.example.org/data/2.5/*",
  "methods": [
    "GET"
  ],
  "services": {
    "dataSource": {
      "rating": {
        "maxCallsCount": 500,
        "periodInMs": 1000
      }
    }
  }
}
IMPORTANT
De configuratie zal slechts actief na het roepen van ​eindpunt opstellen.

Waarschuwing en fouten

Wanneer a canDeploy 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: het in kaart brengen van config: ontbrekende of ongeldige URL
  • ERR_ENDPOINTCONFIG_101: het in kaart brengen van config: misvormde url
  • ERR_ENDPOINTCONFIG_102: het in kaart brengen van config: misvormde url: vervangingsklank in url niet toegestaan in gastheer :port
  • ERR_ENDPOINTCONFIG_103: het in kaart brengen van config: ontbrekende methodes van HTTP
  • ERR_ENDPOINTCONFIG_104: het in kaart brengen van config: geen bepaalde vraagclassificatie
  • ERR_ENDPOINTCONFIG_107: het in kaart brengen van config: ongeldige maximum vraagtelling (maxCallsCount)
  • ERR_ENDPOINTCONFIG_108: het maximum config: ongeldige maximum vraagtelling (periodInMS)
  • ERR_ENDPOINTCONFIG_111: het in kaart brengen van 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 nuttige lading JSON
  • ERR_AUTHORING_ENDPOINTCONFIG_1: ongeldige de dienstnaam <!--<given value>-->: moet "dataSource"of "actie"zijn

De mogelijke waarschuwing is:

ERR_ENDPOINTCONFIG_106: het in kaart brengen van config: maximum de verbindingen van HTTP niet bepaald: geen beperking door gebrek

Gebruiksscenario’s

Deze sectie bevat een overzicht van de belangrijkste gebruiksgevallen voor het beheer van configuraties met begrenzingen in Journey Optimizer en de bijbehorende API-opdrachten die nodig zijn om het gebruiksscenario te implementeren.

De details op elk API bevel zijn beschikbaar in de ​ API beschrijving & inzameling van Postman ​.

Een nieuwe configuratie voor uitlijnen maken en implementeren

API-aanroepen voor gebruik:

  1. list - Hiermee worden bestaande configuraties opgehaald.
  2. create - Maakt een nieuwe configuratie.
  3. candeploy - Controleert of de configuratie kan worden opgesteld.
  4. deploy - Implementeert de configuratie.
Update en stel een het maximum configuratie (nog niet opgesteld) op

API-aanroepen voor gebruik:

  1. list - Hiermee worden bestaande configuraties opgehaald.
  2. get - Hiermee worden details van een specifieke configuratie opgehaald.
  3. update - Hiermee wijzigt u de configuratie.
  4. candeploy - Controleert de geschiktheid voor implementatie.
  5. deploy - Implementeert de configuratie.
Implementeer en verwijder een geïmplementeerde configuratie voor plafonnering

API-aanroepen voor gebruik:

  1. list - Hiermee worden bestaande configuraties opgehaald.
  2. undeploy - implementeert de configuratie ongedaan.
  3. delete - Verwijdert de configuratie.
Een geïmplementeerde uitlijningsconfiguratie in één stap verwijderen

In slechts één API-aanroep kunt u de configuratie met behulp van de parameter forceDelete verwijderen en de implementatie ervan ongedaan maken.

API-aanroepen voor gebruik:

  1. list - Hiermee worden bestaande configuraties opgehaald.
  2. delete(met forceDelete parameter) - Dwingt schrapping van een opgestelde configuratie in één enkele stap.
Een reeds geïmplementeerde configuratie voor plafonnering bijwerken
note
NOTE
Een herplaatsing wordt vereist na het bijwerken van een reeds opgestelde configuratie.

API-aanroepen voor gebruik:

  1. list - Hiermee worden bestaande configuraties opgehaald.
  2. get - Hiermee worden details van een specifieke configuratie opgehaald.
  3. update - Hiermee wijzigt u de configuratie.
  4. undeploy - Hiermee verwijdert u de configuratie voordat u wijzigingen aanbrengt.
  5. candeploy - Controleert de geschiktheid voor implementatie.
  6. deploy - Implementeert de bijgewerkte configuratie.
recommendation-more-help
journey-optimizer-help