integration-apex

/integration-apex

Work with Salesforce integration code — outbound callouts (REST/SOAP) and inbound web services — using --new, --refine, or --bug-fix.

Usage

/integration-apex --new          Create new integration Apex (callout class or inbound service)
/integration-apex --refine       Modify an existing integration class
/integration-apex --bug-fix      Diagnose and fix a bug in integration code

---

--new: Create New Integration Apex

Gather Requirements

Ask the user:

1. Direction? Outbound callout (Salesforce calls external) or Inbound service (external calls Salesforce)?
2. Protocol? REST or SOAP?
3. Authentication method? OAuth 2.0, API Key, JWT, Named Credential?
4. What operation? (sync account data, retrieve order status, POST event, etc.)
5. Does it need retry logic? Circuit breaker?
6. Synchronous or asynchronous execution context?

---

Outbound REST Callout Pattern

public with sharing class ExternalApiService {

    private static final String NAMED_CREDENTIAL = 'ExternalApi'; // Always use Named Credentials

    public static ExternalApiResponse syncAccount(Id accountId) {
        Account acc = [SELECT Id, Name, Industry FROM Account WHERE Id = :accountId WITH USER_MODE LIMIT 1];

        HttpRequest req = new HttpRequest();
        req.setEndpoint('callout:' + NAMED_CREDENTIAL + '/api/v1/accounts');
        req.setMethod('POST');
        req.setHeader('Content-Type', 'application/json');
        req.setHeader('Accept', 'application/json');
        req.setBody(JSON.serialize(new AccountPayload(acc)));
        req.setTimeout(30000); // 30 second timeout

        Http http = new Http();
        HttpResponse res = http.send(req);

        if (res.getStatusCode() == 200 || res.getStatusCode() == 201) {
            return (ExternalApiResponse) JSON.deserialize(res.getBody(), ExternalApiResponse.class);
        } else {
            throw new IntegrationException('API call failed: ' + res.getStatusCode() + ' ' + res.getBody());
        }
    }

    public class AccountPayload {
        public String name;
        public String industry;
        public AccountPayload(Account acc) {
            this.name = acc.Name;
            this.industry = acc.Industry;
        }
    }

    public class ExternalApiResponse {
        public String id;
        public String status;
    }

    public class IntegrationException extends Exception {}
}