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 pasa de la versión Beta a la disponibilidad general. Las actualizaciones y las funciones nuevas incluyen lo siguiente:
- Compatibilidad con Swagger 2.0, incluida la importación por archivo o URL, y compatibilidad con objetos de seguridad con nombres personalizados
- 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ú Contenido > SmartDocs en Drupal
- Lo que se conocía como autenticación de "token personalizado" ahora se denomina "clave de API".
- Objetos de "seguridad" de autenticación definidos a nivel de la revisión
- 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 descripciones de 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 en la versión de disponibilidad general requieren que actualices SmartDocs en tu portal para desarrolladores.
Cualquier página de SmartDocs que ya se haya publicado en tu portal para desarrolladores seguirá 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, SmartDocs se genera a partir del modelo de API que reside en los servicios de administración de API de Edge de Apigee Services. Cualquier cambio que realices en un modelo de API en Edge será el mismo en todos tus entornos de Pantheon (de manera similar a cómo existen los desarrolladores en los entornos de Pantheon).
Para actualizar de la versión beta de SmartDocs a la disponibilidad general, haz lo siguiente:
- Actualiza y prueba la versión 15.05.27 en tus dev o test entornos 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 SmartDocs, exporta como SmartDocs JSON y, luego, importa a tu modelo nuevo con el archivo adjunto.
- Establece las propiedades de seguridad de la revisión de tu modelo. En la página Contenido >
SmartDocs > modelo, selecciona Configuración de seguridad.
- Verifica cualquier autenticación preconfigurada en la página de configuración del modelo (Contenido >
SmartDocs) haciendo clic en Configuración en la columna Operaciones.
- Actualiza las plantillas personalizadas para usar la versión 6 de los recursos CSS y JS, y realiza cambios para reflejar cualquier nombre de objeto nuevo, como authSchemes y apiSchema. Para obtener información sobre la actualización de 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 documentación nueva, actualiza tu producción portal a la versión 15.05.27.
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 | Descripción |
|---|---|
| DEVSOL-487 | El formato de día en Monetization debe poder configurarlo los administradores Ahora, el formato de fecha se puede configurar en Monetization en la configuración de monetización para los formatos de fecha europeos y estadounidenses. |
| DEVSOL-603 | La página de conflicto de planes tiene un formato incorrecto Cuando se compra un plan que se superpone con un plan existente, la página que se muestra ahora tiene un formato adecuado para el usuario. |
| DEVSOL-642 | Mueve las configuraciones 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 corrige el problema que hace que los parámetros de la plantilla no se puedan editar después de enviar la solicitud desde SmartDocs después de borrar el parámetro de la plantilla en la documentación del método. |
| DEVSOL-1013 | Permite editar las direcciones de correo electrónico de los usuarios del portal para desarrolladores El campo de dirección de correo electrónico en 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 mostraba dos veces. Ya se corrigió ese error. |
| DEVSOL-1313 | Admite la importación de archivos o URLs JSON/YAML para Swagger y WADL Ahora, los archivos WADL se pueden importar a través de la URL, y los archivos Swagger se pueden subir. |
| 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 pases a la disponibilidad general 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 crea 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 | El modelo de SmartDocs Petstore se importa 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 meteorológico para tener un ejemplo más exhaustivo del uso de SmartDocs. |
| DEVSOL-1407 | Cron falla cuando hay muchos desarrolladores Cuando se ejecuta Drupal cron, una gran cantidad de desarrolladores causó 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 un vínculo de 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 se vincula a cualquier modelo con métodos publicados. |
Problemas conocidos
Esta versión incluye los siguientes problemas conocidos:
| ID del problema | Descripción |
|---|---|
| DEVSOL-1558 |
Las páginas de métodos de SmartDocs de ejemplo de Petstore no se renderizan correctamente en una instalación
nueva
Las páginas de métodos de ejemplo de Petstore en SmartDocs no se renderizan correctamente en una instalación nueva. Para solucionar este problema, haz lo siguiente:
Los nodos deberían renderizarse correctamente ahora. |