fwrest-client-generator

What problem does it solve?

This Skill solves the problem of integrating Protheus/ADVPL/TLPP with external REST APIs by generating robust, production-ready client code using the FWRest HTTP client instead of ad-hoc or legacy HTTP calls.

Core Features & Use Cases

• FWRest REST Client Generation: Produces end-to-end ADVPL/TLPP code to consume external APIs with GET, POST, PUT, and DELETE verbs using a consistent FWRest lifecycle (New → SetPath/params → headers → invoke → parse result).
• Authentication & Header Construction: Supports No Auth, HTTP Basic, Bearer/JWT, API-key headers, and OAuth 2.0 patterns (including token fetching and caching guidance), with secure credential handling via GetMV.
• Request/Response Robustness: Handles query/path parameters (including URI escaping), timeouts, SSL expectations via appserver.ini, status-code strategy (legacy success vs full 2xx), optional disabled internal status checking to read 4xx/5xx bodies, TLPP Try/Catch wrapping, and safe logging without leaking secrets.
• Use Case: Replace legacy HTTPCGet/HTTPCPost/HTTPQuote logic with a standardized FWRest client for a third-party JSON API integration that must correctly interpret status codes and parse error bodies.

Quick Start

Ask the skill to generate TLPP/ADVPL code that consumes a third-party REST endpoint using FWRest with Bearer token authentication, sends a JSON POST payload, reads the response as JSON, and includes TLPP Try/Catch error handling plus HTTP status-aware logging.