PolyAPI is continuously evolving to meet the dynamic needs of developers and organizations. Release 12 introduces significant enhancements across various client libraries, user interfaces, and AI services, ensuring a more robust, flexible, and efficient experience. These updates reflect our commitment to providing cutting-edge solutions for API management and seamless integration.
Node Client
TypeScript Snippets
To help developers get started quickly, we’ve published an initial set of TypeScript snippets. These snippets cover essential tasks such as making the first API call with Poly, building custom functions, receiving webhook events, validating JWT tokens, and implementing error handling and logging.
Bug Fixes
Resolved local dependency issues in server functions related to type imports, enhancing the stability and reliability of the Node client.
Java Client
Webhook Improvements
We’ve added default blocking and handle-based webhook methods, providing improved control and flexibility. These methods allow listeners to remain active until interrupted or to be easily closed when needed.
Optional Headers and Params
Headers and parameters in server function execution are now optional, offering more flexibility in handling events, headers, and parameters.
New Functions
The Java client now includes a ‘Delete’ function and the ability to ‘Add Server Variable,’ expanding the range of operations available to developers.
Bug Fixes
Fixed issues with the Java library where running ’mvn clean compile’ would fail if an API function returned a JSON object with keys containing spaces. Additionally, server functions now correctly accept primitive types as arguments.
Python Client
Type Improvement
Updated import paths in the Python client to align with TypeScript. Types previously imported from modules with a leading underscore (e.g., ‘from _foobar’) are now imported directly (e.g., ‘from Foobar’), ensuring consistency across languages.
C# Client (Beta)
API Functions
Introduced generation and execution capabilities for API Functions in C#, along with getting started documentation, making it easier for C# developers to integrate Poly API.
Canopy Service (Poly UI)
Expanded Management UI
The Management UI now includes pages for API functions, server functions, and client functions, offering a comprehensive view and management capabilities.
Configuration Update
Canopy configurations now use context + function name for consistent setups across all environments, standardizing the configuration process.
AI Services
Conversations List API
Added the /assistants/{slug}/conversations endpoint, allowing super users to view all conversations for a specific AI assistant.
Detailed Conversations Endpoint
Introduced the GET /assistants/{slug}/conversations/{conversation_id} endpoint to retrieve specific conversation details by ID, enhancing the granularity of data access.
Bug Fixes
Resolved an issue where the AI assistant failed to recognize ApiFunctionResponse behind .data, ensuring accurate response modeling.
Developer Experience
OAS Training Guide
Added a guide on training API functions and webhooks using OpenAPI Specifications, providing a structured approach to API development.
Postman Training Guide
Introduced a guide for using Postman in API function training, covering pre and post-request scripts, enhancing the utility of Postman in the API development workflow.
Generated SDKs
Launched SDKs for TypeScript, Java, and Python to help developers get started with Poly in their preferred language.
Postman Based API Training
Added the ability to easily set an instance URL in Postman pre-request scripts, with default configurations for NA1 and automatic adjustments for EU1.
Bug Fixes
Fixed issues with invalid Bearer token objects from Postman that caused poly training call failures.
Server Improvements
Accelerated Deployment
Improved deployment speed for server functions with external dependencies, reducing initial and redeployment times, and added visibility into deployment progress.
Tenant Functions in Jobs
Added support for tenant and public functions in jobs, allowing them to be published with various visibilities (environment, tenant, public).
Redeployment Enhancement
Enhanced logic to keep current functions active until new versions are ready, avoiding downtime during function redeployment.
Public Functions
Apaleo PMS
Published 282 API & Webhooks Functions, providing full coverage of APIs.
Opera Cloud PMS
Published 14 new OHIP API Functions in cashiering, reservations, configuration, and deposits, expanding the functionality available for integration.
Infrastructure/DevOps Improvements
Server Function Usage Dashboard
Added a second table to the server function dashboard for self-hosted customers. This table displays currently running server functions on Knative, including names, IDs, context, run start time, number of nodes in use, and sleep cycle details, providing deeper insights into server function performance.
Moving Forward
With these updates, Poly API continues to empower developers with more flexible tools, streamlined workflows, and enhanced capabilities. Stay tuned for more improvements and new features as we strive to provide the best API management experience.
For more details, visit our documentation or contact our support team. Your feedback is invaluable as we continue to innovate and enhance Poly API.