Português
English
Español
of-context-params
of-context-params
Resuelve, a partir de la ruta del recurso llamado, qué type RAR y qué actions exige ese endpoint, y se los entrega al paso siguiente. Evita configurar esa exigencia a mano en cada operación.
01 Qué problema resuelve
El of-consent-validation necesita saber qué exige cada endpoint. Alguien tiene que decirle.
Sin este paso, habría que configurar context-authorization-type y context-required-actions operación por operación, en cada API publicada. Con decenas de endpoints regulados, es trabajo repetido y una fuente constante de error: basta olvidar una operación para dejarla sin exigencia declarada.
Este interceptor centraliza ese mapeo en un solo lugar. Lee la ruta de la solicitud, la compara con el catálogo de recursos del SFA, y escribe las dos variables de contexto que el paso siguiente consume.
02 Qué cubre el mapeo
| Familia | Método | type resueltos |
|---|---|---|
| Productos y transacciones | GET | Accounts · CreditCardAccounts · Loans · Investments · Insurances · Customers · Resources · PaymentReports |
| Iniciación de pagos | POST | SinglePayments · ScheduledPayments · RecurringPayments · VariableRecurringPayments · FundsConfirmation |
La resolución es por ruta y, donde hace falta distinguir, también por método. Una subruta puede exigir una action más específica que su ruta base: el saldo de una cuenta exige ReadAccountsBalance, no sólo ReadAccounts.
Las APIs de open data y la Grant Management API quedan fuera del mapeo: no exigen consentimiento RAR. No es un olvido — es la razón por la que una ruta sin mapeo no es, por sí sola, un error.
03 Configuración
| Variable | Dirección | Descripción |
|---|---|---|
context-authorization-type | Salida | El type RAR resuelto desde la ruta. |
context-required-actions | Salida | CSV de las actions que el endpoint exige. |
context-params-strict | Entrada, opcional | true hace que una ruta sin mapeo responda 500. Por defecto sólo registra un aviso y continúa. |
El override manual gana
Si context-authorization-type ya viene configurada en el recurso, el interceptor no la sobrescribe. Es la salida para un endpoint que no encaja en el catálogo, o que exige algo distinto de lo que su ruta sugiere: configúrelo a mano y este paso lo respeta.
Con context-params-strict en true, publicar un recurso regulado nuevo sin mapearlo falla de inmediato y de forma visible. Sin esa variable, la solicitud sigue y queda en manos del of-consent-validation, que la rechazará por falta de exigencia declarada.
La primera opción falla antes y dice por qué; la segunda falla después y dice menos. Para ambientes de producción, prefiera la primera.
04 Errores
code | Cuándo |
|---|---|
SFA_ERR_INTERNAL | Fallo al resolver la ruta, o ruta sin mapeo con context-params-strict activo |
05 Código fuente
El interceptor completo, tal como se instala en la Sensedia API Platform.
of-context-params.js — JavaScript, 12 KB.
Se sirve con extensión .json porque el portal no entrega archivos .js; el contenido es JavaScript. Guárdelo como of-context-params.js.
← Anterior: access-token-authorization · Siguiente: of-consent-validation →
