Página del Administrador del portal en el API Manager de Jitterbit

Introducción

La página Administrador del Portal permite generar documentación de OpenAPI para APIs personalizadas y proxy. La documentación resultante se muestra en el Portal, donde puede interactuar probando las APIs. Esta página describe la interfaz de usuario de la página Administrador de Portal dentro del API Manager.

Limitaciones

La página Administrador del portal tiene estas limitaciones:

• Generación de documentación OpenAPI para servicios OData no es compatible.
• Generación de documentación OpenAPI para servicios API utilizando un método de solicitud personalizado no es compatible debido a una limitación de la especificación OpenAPI. Las APIs que incluyen solo servicios de API de métodos personalizados se muestran solo con un nombre de etiqueta de API.
• Solo se puede crear una única página de Portal para cada ambiente en una organización Harmony.

Acceder a la página del Administrador del Portal

Para acceder a la página Administrador del portal, utilice el menú del portal Harmony para seleccionar API Manager > Administrador del portal:

Encabezado de la página del Administrador del portal {: #portal-manager-page-header }␠ La página Administrador del Portal también se llama Administrar el Portal del Desarrollador, ya que es la página donde se administra lo que aparece en el Portal página (también llamada Administrar portal para desarrolladores).

Estas opciones aparecen en la parte superior de la página Administrador del portal:

• Ambiente: Utilice el menú para seleccionar el ambiente donde se generará la documentación de OpenAPI y luego se mostrará en la página del Portal de una organización.

  Para actualizar la lista de ambiente, haga clic en el icono Icono de actualización.

  Nota

  Solo se puede crear una única página de Portal para cada ambiente en una organización Harmony.

• Ver documentación de la API: Haga clic para ir al Portal página, donde se representa la documentación API interactiva generada.

• Regenerar documentación y publicar: Haga clic para sobrescribir y publicar la documentación de OpenAPI 2.0 en la página del Portal para todas las APIs personalizadas y proxy del ambiente seleccionado. Se excluyen los servicios OData. Si ha publicado una nueva API personalizada o proxy y desea regenerar automáticamente la documentación para incluir las nuevas APIs, debe usar esta opción.

  Advertencia

  Al usar esta opción, se sobrescribe la documentación de la API existente, incluyendo cualquier personalización. Antes de usar esta opción, se recomienda copiar manualmente la documentación de la API existente en un editor de texto externo. Después de regenerar la documentación, vuelva a aplicar manualmente las personalizaciones pegándolas en el editor de documentación de la API según corresponda.

• Guardar y publicar: Haga clic para guardar y publicar la documentación de la API en la página del Portal. Si ha personalizado la documentación de la API generada automáticamente, debe usar esta opción para publicarla en la página del Portal.

Personalizar la página del Portal

La página Administrador del Portal te permite personalizar el Portal página con una imagen, como el logotipo de una empresa, o con ediciones en la documentación de API generada automáticamente:

• Explorar archivos locales: Haz clic para seleccionar una imagen que cumpla con los requisitos:

  

  La imagen subida se publica automáticamente en la página del Portal sin necesidad de hacer clic en Regenerar documentos y publicar ni en Guardar y publicar.

  Para eliminar una imagen después de subirla, haz clic en Eliminar imagen:

  

• Organización: La organización Harmony a la que se está accediendo actualmente.

• URL base: La URL base del servicio API. Haga clic en el icono Copiar icono para copiar la URL base a su portapapeles.

Editar la documentación de la API

Documentación interactiva según la Especificación OpenAPI 2.0 se genera automáticamente para todas las APIs personalizadas y proxy en el ambiente seleccionado.

Las definiciones de OpenAPI se muestran en el editor en el lado izquierdo de la página y se representan como una IU de Swagger interactiva) documentación en el lado derecho de la página.

Puede editar las definiciones de OpenAPI directamente en el editor, en la parte izquierda de la página. Estos son ejemplos de personalizaciones para la documentación de la API:

• Completar metadatos sobre la API, incluidos Campos fijos como title, description, termsOfService, contact, license, y version- Sobrescribir manualmente la documentación usando la Especificación OpenAPI 3.0.

Después de realizar modificaciones en la documentación de la API, haga clic en Guardar y publicar para guardar y publicar la documentación en el Portal página.

Para regenerar y publicar documentación después de publicar una nueva API, utilice el botón Regenerar documentación y publicar.

APIs de prueba

La documentación de API generada a partir de las definiciones de OpenAPI que se muestran en el editor en el lado izquierdo de la página se representa como una IU de Swagger interactiva) documentación en la parte derecha de la página. Puedes usar el swagger interactivo para probar los servicios de la API:

• Esquemas: Utilice el menú desplegable para seleccionar entre los esquemas disponibles compatibles con las definiciones de OpenAPI.

• Autorizar: Si alguna de las APIs dentro del ambiente seleccionado requiere una autorización establecida por un perfil de seguridad asignado), se muestra el botón Autorizar. Al hacer clic, se muestra un cuadro de diálogo con las autorizaciones disponibles. Complete los datos necesarios para probar las APIs con los métodos de autorización proporcionados.

Al hacer clic en Autorizar, se mostrarán las autorizaciones disponibles. Complete los datos necesarios para probar las APIs con los métodos de autorización proporcionados:

![autorizaciones disponibles](/_download/images/apim/user-interface/portal-manager/available-authorizations.png)

Servicios API

Cada servicio API se enumera con su método:

El icono de autorización indica si el servicio API requiere autorización:

• : No se requiere autorización.
• : Se requiere autorización.

Haga clic en la fila del extremo para ver información sobre sus parámetros y respuestas, que se describen a continuación.

Pruébalo

En un servicio de API expandido, haga clic en el botón Pruébelo para probar la API. Se expande una solicitud de API configurable:

• Cancelar: Haga clic para contraer la solicitud de API configurable.

• Ejecutar: Una vez configurados todos los campos de solicitud, haga clic para generar el Curl y la URL de solicitud para usar en las pruebas:

  

  • Curl: La solicitud cURL para los valores ingresados en los campos de solicitud de API. Haga clic en el Copiar icono para copiar la cURL a su portapapeles.

  • URL de solicitud: La URL de solicitud para los valores ingresados para los campos de solicitud.

• Borrar: Haga clic para borrar los valores ingresados para los campos de solicitud de API.

Posibles respuestas de API : aquellas incluidas en la documentación de API - se muestran para cada servicio API:

• Respuesta del servidor: Muestra las respuestas del servidor documentadas.

• Respuestas: Muestra los códigos de estado HTTP documentados y sus descripciones.