Aanroepen en callbacks: Limieten en gebruik
Limieten en beste benaderingen voor callbacks en aanroepen van en naar Externe services.
Vereiste editions
| Beschikbaar in: Lightning Experience |
| Beschikbaar in: Enterprise, Performance, Unlimited en Developer Edition |
- Aanroepen van externe services zijn niet toegestaan wanneer er transacties in behandeling zijn, die dus nog niet zijn vastgelegd.
- Sluit uw transactie in Flow en hervat Flow met behulp van het stroomelement Onderbreken.
- Voer in Apex de aanroep uit vóór een DML-instructie zoals het invoegen, bijwerken of verwijderen van objecten. Zie Callout Limits and Limitations in de Apex Developer Guide.
- Time-out voor aanroepen naar Externe services na 120 seconden.
Externe services Asynchrone callbacks
De time-outduur van een call-backbewerking wordt geconfigureerd in de Apex client en kan worden ingesteld op maximaal vierentwintig uur.
Geaccepteerde callback-HTTP-methoden zijn PUT en POST. Alle andere methoden worden genegeerd.
Eén callbackparameter mag slechts één callbackbewerking bevatten, aangezien een één-op-veel relatie niet wordt ondersteund. Als één-op-veel wordt gedetecteerd, wordt alleen de eerste callbackbewerking onder de callbackparameter verwerkt.
In Voorbeeld-API-specificatie met call-backbewerking is de eerste call-backparameter applicationOutcomeApproved. Het bevat één #ref/…/ApplicationApproved callbackbewerking. De derde callback-parameter is applicationError. Het bevat één "{$request.query.callbackUrlForErrorCases}": {"post":
{.....}}} 3.3 callbackbewerking. We negeren de callbackbewerkingsresponsdeclaratie en sturen altijd 200, 404, 408 (time-out) of 500 HTTP-respons naar de callback-afzender.
Een callback-URL kan worden gedefinieerd als een queryparameter of worden toegevoegd aan de hoofdtekstparameter van het verzoek. Een callback-URL kan zijn:
- een tekenreekstype
- een eigenschap van een objecttype
- een element van een array
Enkele geldige notaties voor callback-URL-expressies zijn:
-
'{$request.query.callbackUrl}' -
'{$request.body#/callbackUrl}' -
'{$request.body#/callbackUrl/1}'
Andere complexe expressies worden momenteel niet ondersteund. Bijvoorbeeld expressies met statische tekst in combinatie met variabele verwijzingen, of expressies die meerdere variabele verwijzingen hebben. In deze niet-ondersteunde gevallen wordt de callback als ongeldig beschouwd en wordt de bewerking geprobeerd als een synchrone aanroep met een time-out van 120 seconden.
Een callback-bewerking kan een operationId definiëren. Zie bijvoorbeeld in Voorbeeld-API-specificatie met callbackbewerking:
"operationId": "approvedCallback”
Deze operationId kan niet worden gedupliceerd met andere operationId - met een reguliere bewerking op het hoogste niveau
"operationId": "SubmitApplication”
of andere callback operationId.
Als een call-backbewerking geen operationId declareert, gebruikt Salesforce de verwijzingsnaam van de call-backcomponent als de operationId - in dit geval - ApplicationRejected.
Als de callback-bewerking inline wordt gedeclareerd, wordt de operationId ervan opgebouwd als
parentAsyncOperationId_CB_callbackParameterName
Bijvoorbeeld SubmitApplication_CB_applicationError.
