Saltar al contenido principal
PUT
Reemplazar la lista de proveedores permitidos
Reemplaza todo el conjunto de proveedores que ofrece tu organización por los ids del cuerpo. Un proveedor que el cuerpo omite deja de ofrecerse. Esto es un reemplazo, no una fusión: usa Actualizar la visibilidad de varios proveedores para cambiar algunos proveedores sin volver a indicar el resto. Quitar un proveedor conserva su personalización de instrucciones, de modo que desactivarlo y volver a activarlo no pierde tu redacción.

Cuerpo

string[]
requerido
El conjunto completo de ids de proveedores que ofrece tu organización. Ids de catálogo en UPPER_SNAKE_CASE ([A-Z0-9_]), de máximo 100 caracteres cada uno y como máximo 500 entradas. No distingue mayúsculas de minúsculas: se normaliza a mayúsculas.Un arreglo vacío es una solicitud válida y borra la lista de permitidos, con el mismo estado final que Borrar la lista de proveedores permitidos. Por lo tanto, una pantalla de administración de “guardar todo” no necesita un caso especial para “se desmarcó el último proveedor”.
Bajo la regla de opt-in, un provider_ids vacío deja a tu organización sin ninguna entrada en la lista de permitidos: no es un interruptor de “mostrar todo”. Envía los ids que quieres ofrecer en lugar de borrar la lista para ampliarla.

Respuesta

La personalización actualizada, con la misma estructura que Listar la personalización de proveedores de marca blanca.
boolean
Indica si tu organización tiene al menos una entrada en la lista de permitidos, después de este cambio.
object[]
La unión de tu lista de permitidos, tus personalizaciones de instrucciones y tus personalizaciones de logo.

Errores

Autorizaciones

PUBLIC-API-KEY
string
header
predeterminado:<Your PUBLIC-API-KEY>
requerido
PRIVATE-SECRET-KEY
string
header
predeterminado:<Your PRIVATE-SECRET-KEY>
requerido

Cuerpo

application/json

El conjunto completo de ids de proveedores que se ofrecerán.

provider_ids
string[]
requerido

El conjunto completo de ids de proveedores que ofrece la organización. Ids de catálogo en UPPER_SNAKE_CASE ([A-Z0-9_]), de hasta 100 caracteres cada uno, con un máximo de 500 entradas.

Maximum array length: 500
Maximum string length: 100
Ejemplo:

Respuesta

La capa actualizada.

filtered
boolean

Indica si la organización tiene al menos una entrada en la lista de permitidos. Bifurca según este campo, nunca según la longitud de providers: la lista también tiene elementos cuando las únicas entradas son personalizaciones de instrucciones o logotipos.

Ejemplo:

true

providers
object[]

La unión de la lista de permitidos, las personalizaciones de instrucciones y las personalizaciones de logotipos. Un proveedor puede tener redacción o logotipo personalizado sin ser ofrecido, en cuyo caso aparece con allowed: false.