Map your systems
Import and export
Bring in OpenAPI, Postman, Pact and browser recording (HAR) files, sync again when they change, and export OpenAPI and Pact.
Open Import in the appWhat you can import
Import a file
- Press New beside search, then Import. On the map you can also choose Import OpenAPI / HAR from the toolbar's more menu.
- Paste the file into Paste JSON or YAML, or drop a file, drop it there, or press Choose file. To try it out, press Load sample on a format.
- Press Analyze. The review shows the format it found and how many endpoints it read.
- Choose the system the endpoints belong to, or create a new one from the list.
- For expectations, choose the Provider they call. For HAR and Postman files with several hosts, use Map each host to a provider system. Choose Skip for a host you don't want.
- Check the table, then press the import button. It says how many endpoints it will import.
- Import complete shows what was added. Every contract was checked straight away. Press View on map.
OpenAPI details
$refreferences are resolved andallOfparts are merged.oneOfandanyOfstay as a choice of shapes. When the side that sends may send several shapes, the receiver must take each of them, and a mismatch says which option it is about.- In Swagger 2, an
in: bodyparameter is the request body.in: formDataparameters become a form body, with files as binary strings.
Import again to sync
When your spec changes, import it again into the same system. The import becomes a sync:
- The summary line reads "Sync with" the system, then counts new, changed, unchanged and not in this file.
- Each changed endpoint opens to its list of changes, each marked breaking, additive or neither. If it breaks consumers, it says how many and why.
- Not in this file lists endpoints the system has but the file doesn't. Tick the ones to remove. The rest stay as they are.
- Press Apply changes.
A changed endpoint keeps its identity, so its history carries on. If the file is the same as the system, you see "Everything in this file is already up to date."
Export OpenAPI
- Open the provider system's Settings tab.
- Press Export OpenAPI.
- Under Export, choose The system now or one of its releases.
- Press Copy or Download.
The document is OpenAPI 3.1. Its info.version is the release, or a prerelease such as 1.4.0-next.3 when the system changed since its newest release. An x-rabbinatix block records the system, the release and a hash of the content.
Copying or downloading records the export. The next time you open it, it says "Same as" or "Changed since" the last export, with one line per changed endpoint marked Big change, Addition or Fix.
Export Pact
- Open the connection between the consumer and the provider.
- Choose Export Pact from the more menu.
- Press Copy.
The Pact file holds the consumer's expectations of that provider, so a team can keep running Pact verification. How the two compare and work together: Pact and Rabbinatix.
Check a copy later
Every OpenAPI export can be checked: paste it into Check my copy on the Releases page (pick the system) to see whether it is still current and what changed since. See Versions and releases.
Related
- APIs and contractsDeclare what providers offer and what consumers expect. Rabbinatix pairs them into contracts and checks them field by field.
- Versions and releasesRun API versions side by side, read the history and diff of every endpoint, create releases with a suggested version, and check old copies.
- CI and the APIGate deployments in CI with the safety check and record what you deploy, using an API token and the HTTP API.
