WPM Changelog

Public API v1 and API tokens #

The WPM public API v1 is now available. Make a personal API token in the WPM, then use your projects and connectors from other tools.

WPM

• We added the API Tokens page to the account menu. On this page, you make personal tokens for the public API and revoke them. Each token has a name, one or more scopes, and a lifetime of 30, 90, 180, or 365 days. The WPM shows a new token one time only, so copy it immediately. You can have up to 20 active tokens.
• The header bar has a new API Docs link. It opens the API reference in a new tab.
• Bug fixes:
  • When you leave the editor after you open a pop-up, for example Categories, the WPM now continues correctly. Before, it could stop with an error.
  • When a publish fails, the error message now lists the problems in the project. The wire numbers in the list are now the same as in the editor. Before, the message showed code text.
  • When a save fails because of a server error, the message now shows as normal text. Before, it showed code text.
  • When you make a connector with a name that you already use, the WPM now shows an error. Before, it showed that it made the connector, but it did not.
  • The error for a contact that its connector position does not accept is now the same for end 1 and end 2. Before, end 1 showed "Pin is no longer available".

Public API

• The WPM public API v1 is now available at https://wpmapi.yourspec.com/v1. Your tools can use it to work with your own projects and connectors.
• Each call needs a personal API token from the API Tokens page. Send it as a Bearer token. The scopes of a token set what it can do: Read projects, Edit projects, Delete projects, Read connectors, and Edit connectors.
• Use the project operations to make a project, copy a published project, publish its draft, and delete a project. You can copy your own projects, and public, unlisted, and template projects.
• Use the draft operations to get the draft, replace it, check it, and discard it. A check gives the issues and the price, and it does not save. A draft has an ETag. Send it in If-Match when you save, and the API refuses the save (412) if the draft changed.
• Use the connector operations to list, get, make, change, and delete your own connectors. When a project uses a connector, you can change only its details and position labels, and you cannot delete it.
• The catalog operation gives the wires and cables, contacts, connectors with their positions, label types, mark intervals, and project limits. Any valid token can use it.
• Errors use the problem+json format with a stable error code. A validation error lists each problem with its severity and the JSON path of the field. An "error" stops the save, an "incomplete" issue stops the publish, and a "warning" is information only.
• The API reference and the OpenAPI specification are on the API host. The specification is at https://wpmapi.yourspec.com/openapi/v1.json.

API reference: https://wpmapi.yourspec.com/docs/