Getting started
This section gets you oriented and running. Read it in order if you're new; jump straight to the Quickstart if you just want a published service in front of…
This section gets you oriented and running. Read it in order if you're new; jump straight to the Quickstart if you just want a published service in front of you.
Current release: v1.0 (General Availability). See the release notes.
In this section
- Introduction — what SOAP-2-REST by Specaria is, the Publish/Consume model, where it sits in your stack, and who it's for.
- Core concepts — the operator vocabulary: service, operation, mapping, mapping version, Publish vs Consume, discovery, learned example, connector, conversion option, correlation ID, contract drift, RBAC roles, and environment. Read this before the Quickstart so the UI labels make sense.
- Quickstart — the fastest path from zero to a published service: stand up the standalone Docker Compose stack, import a WSDL, configure the backend, review the generated OpenAPI v3, publish, and make a test call.
- System requirements — PostgreSQL, container runtime, JVM, supported deployment targets, network egress for licensing, payload limits, and the capacity baseline.
Suggested reading order
- Introduction — understand the model.
- Core concepts — learn the vocabulary.
- System requirements — confirm your target host qualifies.
- Quickstart — bring up the stack and publish your first service.
When you're past the basics:
- Installation — production deployment targets (GCP, Kubernetes / OpenShift Helm, Docker Compose).
- Onboarding a service — the full WSDL → publish workflow with all options.
- Discovery & connectors — turn on traffic-driven discovery.
- Support — how to get help and the support tiers.
Conventions used throughout the KB
- Error codes look like
S2R-RUN-0413(service prefix + numeric code). See the error-codes reference. - Database tables are prefixed
s2r_; the Java package root iscom.specaria.s2r. - Customer-specific values (hostnames, project IDs, group names) appear as placeholders in
<angle-brackets>. - A Since v1.0 note marks where a capability first became available.
