Crear un metafield de subopción de extra
API operation: Abrir la operación en la Referencia de la API
Usa POST /business/{business_id}/extras/{extra_id}/options/{option_id}/suboptions/{suboption_id}/metafields para crear metadatos para una subopción de extra. La operación pública vigente es ExtraOptionSuboptionMetafield.register.
Los identificadores forman una jerarquía: business_id identifica el negocio, extra_id el extra que le pertenece, option_id una opción de ese extra y suboption_id una subopción de esa opción. La operación verifica esta jerarquía antes de crear el metafield.
La asociación usa suboption_id como identidad del modelo ExtraOptionSuboption y como ID del objeto del metafield. Los campos key, value y value_type aceptan estos tipos: integer, decimal, boolean, text y json. La estructura de la solicitud depende de la operación enlazada.
La operación descrita requiere autenticación de administrador o administrador de negocio. Un administrador de negocio está limitado a los negocios asociados con su usuario.
Esta coincidencia exacta de método y ruta establece únicamente la correspondencia de la operación. Consulta cómo listar metafields de subopciones de extra para la lectura de la colección.
Referencia de OpenAPI
Operación: POST /business/{business_id}/extras/{extra_id}/options/{option_id}/suboptions/{suboption_id}/metafields
Parámetros de ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
business_id | integer | Sí | — |
extra_id | integer | Sí | — |
option_id | integer | Sí | — |
suboption_id | integer | Sí | — |
Campos del cuerpo de la solicitud
| Nombre | Tipo | Obligatorio |
|---|---|---|
model | any | Sí |
object_id | integer | Sí |
value | any | Sí |
value_type | string | Sí |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta exitosa. El contenido de result varía según la operación y se devuelve como JSON. |
| 400 | Respuesta de error (error=true). Los errores de validación y de negocio comparten este código. |
| 401 | Respuesta de error: sesión ausente, inválida, o nivel de usuario fuera de los permitidos. Respuesta de error: el proyecto no existe o no tiene una suscripción activa. |
| 404 | Respuesta vacía: la versión de API solicitada no está admitida. |
| 429 | Envelope de error: se excedió un límite de consumo del proyecto (o el sujeto está baneado). Lleva Retry-After y X-RateLimit-Limit/Remaining/Reset/Scope/Key. |
| 500 | Respuesta de error: falló la búsqueda o inicialización del proyecto. |
| 503 | Envelope de error: la aplicación está temporalmente en mantenimiento. Envelope de error: el proyecto está temporalmente en mantenimiento, o los límites de consumo no se pudieron evaluar y el límite aplicable está configurado con on_error = closed (cabecera Retry-After: 1). |