Support

Posteçî support

Answers to common questions, and how to reach us.

Getting started

How do I send my first request?

Choose Open Example Workspace on the welcome screen, select a request in the sidebar and press Send (⌘↩). The examples call public test APIs, so answers come back right away.

How do I start my own workspace?

A workspace is any folder of .stamp or .http files. Choose Open Workspace… and pick a folder, or create an empty one there. File › New Request (⌘N) adds requests; everything you change is saved into the files straight away.

Where is the language described?

The language reference covers requests, variables, scripts, test plans, load tests and environments.

Files and workspaces

Why does Posteçî ask for a folder when I open a .stamp file from Finder?

Mac App Store apps can only read what you give them. Opening a file grants that file, but a request usually needs the rest of its workspace: environment.stamp, other requests and data files. Choose the workspace folder once and Posteçî remembers it.

Can I edit the files in another editor?

Yes. Posteçî watches the workspace and picks up changes made anywhere, including a text editor or a git pull.

A body or data file isn't found

Paths in < ./file bodies, readJson and readText are relative to the .stamp file and must stay inside the workspace folder.

Environments and secrets

What are dimensions?

Axes your API varies along, such as environment, region or user. Pick a value for each in the toolbar, or * for any, and every variable set that matches applies. Edit them with Environment › Edit Dimensions….

Why are some values blurred?

Tokens, passwords, cookies, JWTs and anything passed through secret() are blurred so they don't end up in a screenshot or a screen share. Click one to show it, or choose Request › Show Secrets (⇧⌘H) to show them all. You can turn blurring off in Settings.

Where do my personal tokens go?

Into environment.local.stamp, next to environment.stamp. When the workspace is a git repository, Posteçî adds that file to .gitignore, so it stays on your Mac.

Teams and the command line

How do I share a workspace with my team?

Put the workspace folder in a git repository, next to your code if you like, and commit and pull with the tools you already use. Posteçî reloads whatever changes.

Is there a command-line tool?

posteci runs the same workspaces in a terminal and in CI. It will be a free download from this site.

Troubleshooting

A request to a server with a self-signed certificate fails

Add @insecure to the request to skip certificate checks for it.

A request to localhost fails

Check that the server is running and listening on that port. Posteçî can reach localhost and other machines on your network.

Contact

Something not working, or an idea for Posteçî? Write to privacy@siamand.cc with your macOS version and, if you can, the request that misbehaves (with its secrets removed).