Estás viendo la documentación de Apigee Edge.
Ir a la documentación de
Apigee X. info
El martes 2 de junio de 2015, lanzamos una nueva versión en la nube del portal de servicios para desarrolladores de Apigee.
Si tienes preguntas, comunícate con el equipo de asistencia de Apigee Edge.
Para obtener una lista de todas las notas de la versión de Apigee Edge, consulta las Notas de la versión de Apigee.
Nuevas funciones
Disponibilidad general de SmartDocs
SmartDocs pasará de la versión beta a la disponibilidad general. Las actualizaciones y las funciones nuevas incluyen lo siguiente:
- Se agregó compatibilidad con Swagger 2.0, incluida la importación por archivo o URL, y con objetos de seguridad con nombres personalizados.
- Se realizaron mejoras en el diseño visual de las plantillas que generan SmartDocs.
- Mejoras en la usabilidad y el flujo de trabajo en el portal para desarrolladores, disponibles a través del menú Content > SmartDocs en Drupal.
- Lo que se conocía como autenticación con "token personalizado" ahora se denomina "clave de API".
- Son objetos de "seguridad" de autenticación definidos a nivel de la revisión.
- Es la configuración de la autenticación del cliente a nivel de la plantilla. Las revisiones nuevas ya no restablecen las credenciales de cliente de SmartDocs preconfiguradas.
Para obtener más información sobre las funciones, consulta esta entrada de blog.
Para obtener documentación sobre SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
Proceso de actualización de SmartDocs
Si ya usaste SmartDocs durante el período beta, las nuevas funciones y capacidades de la versión de disponibilidad general requieren que actualices SmartDocs en tu portal para desarrolladores.
Las páginas de SmartDocs que ya se publicaron en tu portal para desarrolladores seguirán funcionando, pero debes seguir el proceso de actualización antes de editar o publicar cualquier cambio en las páginas existentes o nuevas.
Ten en cuenta que, si bien puedes renderizar y publicar SmartDocs dentro de tu portal para desarrolladores, los SmartDocs se generan a partir del modelo de API que reside en los servicios de administración de APIs de Edge de Apigee. Todos los cambios que realices en un modelo de API en Edge serán los mismos en todos tus entornos de Pantheon (de manera similar a cómo existen los desarrolladores en los entornos de Pantheon).
Cómo actualizar de la versión beta de SmartDocs a la disponibilidad general
- Actualiza y prueba la versión 15.05.27 en tus entornos de desarrollo o prueba en Pantheon.
- Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
- Si importaste documentos de Swagger o WADL, vuelve a importarlos en una revisión nueva.
- Si mantuviste tu modelo de API a través del módulo de SmartDocs, expórtalo como JSON de SmartDocs y, luego, impórtalo a tu nuevo modelo con un archivo adjunto.
- Establece las propiedades de seguridad de la revisión de tu modelo. En la página Content > SmartDocs > model, selecciona Security Settings.
- Haz clic en Configuración en la columna Operaciones para verificar cualquier autenticación preconfigurada en la página de configuración del modelo (Contenido > SmartDocs).
- Actualiza las plantillas personalizadas para que usen la versión 6 de los recursos CSS y JS, y realiza los cambios necesarios para reflejar los nombres de los objetos nuevos, como authSchemes y apiSchema. Para obtener información sobre cómo actualizar las plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar APIs.
- Vuelve a renderizar y publicar la revisión del modelo.
- Después de validar la nueva documentación, actualiza tu portal de producción a la versión del 27/05/15.
Si eres cliente empresarial de Edge y tienes preguntas o inquietudes sobre el proceso de actualización, envía un correo electrónico a marsh@apigee.com y cnovak@apigee.com. De lo contrario, usa la Comunidad de Apigee para obtener la mejor respuesta.
Fallas corregidas
En esta versión, se corrigieron los siguientes errores.
| ID del problema | Description |
|---|---|
| DEVSOL-487 | Los administradores deben poder configurar el formato de día en Monetización Ahora se puede configurar el formato de fecha en Monetización, en la configuración de monetización para los formatos de fecha de Europa y EE.UU. |
| DEVSOL-603 | La página de conflicto de planes tiene un formato deficiente Cuando se compra un plan que se superpone con uno existente, la página que se muestra ahora tiene un formato adecuado para el usuario. |
| DEVSOL-642 | Mueve la configuración a nivel del cliente de la configuración de seguridad a la configuración de la plantilla |
| DEVSOL-709 | SmartDocs: El parámetro de plantilla de URL no se puede editar después de enviar la solicitud con un valor vacío Se corrigió el problema que hacía que los parámetros de plantilla no se pudieran editar después de enviar la solicitud desde SmartDocs tras borrar el parámetro de plantilla en la documentación del método. |
| DEVSOL-1013 | Habilitar la edición de las direcciones de correo electrónico de los usuarios del portal para desarrolladores El campo de dirección de correo electrónico de la página de edición del perfil ya no estará inhabilitado y los desarrolladores podrán cambiar sus direcciones de correo electrónico. |
| DEVSOL-1273 | "DevConnect Mint" aparece dos veces en la lista de módulos En Módulos, "Dev Connect Mint" se mostró dos veces. Ya se corrigió ese error. |
| DEVSOL-1313 | Se admite la importación de archivos o URLs JSON/YAML para Swagger y WADL Ahora se pueden importar archivos WADL a través de URLs y subir archivos Swagger. |
| DEVSOL-1339 | Cambia las ubicaciones del menú de administrador de SmartDocs SmartDocs ahora se encuentra en el menú de contenido, y la configuración de SmartDocs está en el menú de administrador de configuración. |
| DEVSOL-1340 | Quita la versión beta cuando se lanza la versión GA SmartDocs ahora se encuentra en el menú de contenido, y la configuración de SmartDocs está en el menú de administrador de configuración. |
| DEVSOL-1390 | Se actualizó la biblioteca Edge del SDK de PHP para corregir el problema de llamar a __toString() Se actualizó la biblioteca Edge del SDK de PHP para corregir el problema de llamar a __toString() en el objeto DeveloperRatePlan, que genera este error: {quote} Fatal error: Call to a member function format() on a non-object in /Applications/MAMP/htdocs/ordnance/docroot/profiles/apigee/libraries/mgmt-api-php-sdk/Apigee/Mint/DeveloperRatePlan.php on line 221 {quote} Este es un error que solo afecta a los clientes de Monetization con código personalizado que llama al método toString(). |
| DEVSOL-1398 | Se importó el modelo de Petstore de SmartDocs durante la instalación sin solicitarle al usuario SmartDocs ahora importa el ejemplo de Swagger de Petstore durante la instalación del sitio (http://petstore.swagger.io/v2/swagger.json) en lugar del modelo del clima para tener un ejemplo más exhaustivo del uso de SmartDocs. |
| DEVSOL-1407 | Cron falla cuando hay muchos desarrolladores Cuando se ejecutaba Cron de Drupal, una gran cantidad de desarrolladores provocó un problema de tiempo de espera. Cuando una organización tiene más de 200 usuarios, ahora se usa un proceso por lotes. |
| DEVSOL-1470 | Crea el vínculo del menú "APIs" y la vista correspondiente SmartDocs del portal para desarrolladores ahora incluye de forma predeterminada un vínculo a la documentación renderizada de SmartDocs en el menú principal llamado "APIs", que vincula a cualquier modelo con métodos publicados. |
Problemas conocidos
Esta versión contiene los siguientes problemas conocidos:
| ID del problema | Description |
|---|---|
| DEVSOL-1558 |
Las páginas de métodos de ejemplo de SmartDocs de Petstore no se renderizan correctamente en una instalación nueva
Las páginas de ejemplo del método Petstore en SmartDocs no se renderizan correctamente en una instalación nueva. Para solucionar este problema, haz lo siguiente:
Ahora los nodos deberían renderizarse correctamente. |