Estás consultando la documentación de Apigee Edge.
Consulta la
documentación de Apigee X. Información
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, ve a Asistencia al cliente de Apigee.
Para obtener una lista de todas las notas de la versión de Apigee Edge, consulta Notas de la versión de Apigee.
Funciones nuevas
Disponibilidad general de SmartDocs
SmartDocs pasará de estar beta a disponibilidad general. Entre las actualizaciones y funciones nuevas, se incluyen las siguientes:
- Compatibilidad con Swagger 2.0, incluida la importación por archivo o URL, así como la 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 en el menú Contenido > SmartDocs en Drupal.
- Lo que se conoció como la autenticación de "token personalizado" ahora se denomina "clave de API".
- Objetos de “seguridad” de autenticación definidos a nivel de revisión
- Configuración de la autenticación de cliente a nivel de plantilla. Las revisiones nuevas ya no restablecen las credenciales de cliente de SmartDocs preconfiguradas.
Para ver más descripciones de funciones, consulta esta entrada de blog.
Si deseas ver la documentación de SmartDocs, consulta Cómo usar SmartDocs para documentar las API.
Proceso de actualización de SmartDocs
Si ya usaste SmartDocs durante el período beta, las funciones y capacidades nuevas en 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 cambios en las páginas existentes o nuevas.
Ten en cuenta que, si bien puedes procesar y publicar SmartDocs dentro de tu portal para desarrolladores, SmartDocs se generan a partir del modelo de API que se encuentra en los servicios de administración de API perimetral de Apigee. Cualquier cambio que realices en un modelo de API en Edge será el mismo en todos tus entornos de Pantheon (de manera similar a como existen los desarrolladores en los entornos de Pantheon).
Cómo actualizar de la versión beta de SmartDocs a disponibilidad general
- Actualiza y prueba la versión 15.05.27 en tus entornos dev o test en Pantheon.
- Crea un modelo nuevo para reemplazar cualquier modelo de API existente que hayas estado usando.
- Si has estado importando documentos de Swagger o WADL, vuelve a importarlos a una revisión nueva.
- Si has mantenido tu modelo de API mediante el módulo de SmartDocs, exporta como archivo JSON de SmartDocs y, luego, impórtalo a tu modelo nuevo mediante el archivo adjunto.
- Configura 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 v6 de los elementos de CSS y JS, y realiza cambios para que reflejen cualquier nombre de objeto nuevo, como authSchemes y apiSchema. Si quieres obtener información sobre la actualización de plantillas de SmartDocs, consulta Cómo usar SmartDocs para documentar las API.
- Vuelve a renderizar y publica la revisión del modelo.
- Después de validar la documentación nueva, actualiza tu portal de production a la versión 15.05.27.
Si eres cliente de una empresa 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 | Los administradores deben configurar el formato de día en la monetización El formato de fecha ahora se puede configurar en Monetización en la configuración de monetización para los formatos de fecha europeo y de EE.UU. |
DEVSOL-603 | La página del plan de conflictos tiene un formato incorrecto Cuando compras un plan que se superpone con un plan existente, la página que se muestra ahora tiene el 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 plantillas |
DEVSOL-709 | SmartDocs: el parámetro de plantilla de URL no se puede editar después de enviar la solicitud con el valor vacío Se corrige el problema por el que no se pueden editar los parámetros de la plantilla después de enviar la solicitud desde SmartDocs después de borrar el parámetro de plantilla en la documentación del método. |
DEVSOL-1013 | 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 se inhabilitará, y los desarrolladores podrán cambiar sus direcciones de correo electrónico. |
DEVSOL-1273 | "DevConnect Mint" aparece dos veces en la lista Modules En Modules, "Dev Connect Mint" se mostró dos veces. Ya se corrigió ese error. |
DEVSOL-1313 | Admite archivos JSON/YAML o importación de URL tanto para Swagger como de WADL Los archivos WADL ahora se pueden importar a través de URL y se pueden subir archivos de 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, en el menú de configuración de administrador. |
DEVSOL-1340 | Quitar la versión beta durante la fase de DG SmartDocs ahora se encuentra en el menú de contenido, y la configuración de smartdocs está en el menú de configuración de administrador. |
DEVSOL-1390 | La biblioteca de Edge del SDK de PHP se actualizó para corregir el problema de llamar a __toStringString() Se actualizó la biblioteca de PHP SDK Edge para corregir el problema de llamar a __toApigeeString() en el objeto DeveloperRatePlan que crea el siguiente error: {cita} Error irrecuperable: Call to a member function format() en un no objeto en /Applications/MAMP/htdocs/ordnance/presupuesto de los clientes. |
DEVSOL-1398 | Modelo de Petstore de SmartDocs importado durante la instalación sin solicitar al usuario SmartDocs ahora importa el ejemplo de swagger de la tienda de mascotas 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 ejecutaba cron de Drupal, una gran cantidad de desarrolladores causaron 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 | Vínculo del menú Crear "APIs" y 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 denominado "APIs", que se vincula a cualquier modelo con métodos publicados. |
Problemas conocidos
Esta versión tiene 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 del método de Petstore de ejemplo en SmartDocs no se procesan correctamente en una instalación nueva. Para solucionar este problema, haz lo siguiente:
Los nodos deberían renderizarse correctamente. |