---
title: "Guides"
description: "Step-by-step guides to help you build, integrate, and optimize with our platform. Start coding faster with practical examples and best practices."
url: "https://developer.collectors.com/guides"
image: "https://developer.collectors.com/_og/d/c_Ocean.takumi,title_Guides,description_~U3RlcC1ieS1zdGVwIGd1aWRlcyB0byBoZWxwIHlvdSBidWlsZCwgaW50ZWdyYXRlLCBhbmQgb3B0aW1pemUgd2l0aCBvdXIgcGxhdGZvcm0uIFN0YXJ0IGNvZGluZyBmYXN0ZXIgd2l0aCBwcmFjdGljYWwgZXhhbXBsZXMgYW5kIGJlc3QgcHJhY3RpY2VzLg,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiNFRTA0MDMifX19,p_Ii9ndWlkZXMi,s_LpwzUUYDbSJ-yVZ3.png"
---

## Guides

Step-by-step guides to help you build, integrate, and optimize with our platform. Start coding faster with practical examples and best practices.

## [API Management](#api-management)

Whether you are publishing your first API or managing a growing catalog, these guides walk you through the full API lifecycle on the PSA Developer Portal. Each guide is task-focused, with clear steps, examples, and checklists you can follow along with.

Good API management starts with a consistent approach: describe every API with an OpenAPI specification, publish it with predictable versioning, and keep documentation current as the API evolves. The guides below cover each of these practices.

### [Where to start](#where-to-start)

-   **[Document APIs](https://developer.collectors.com/guides/document-apis)** – Write clear, complete API documentation using OpenAPI, including descriptions, examples, and error responses, so developers can integrate with confidence.
-   **[Publish APIs](https://developer.collectors.com/guides/publish-apis)** – Make your APIs discoverable by publishing them to the portal, controlling visibility, and managing versions and changes over time.
-   **[Versioning](https://developer.collectors.com/guides/publish-apis/versioning)** – Introduce breaking changes safely with a clear versioning and deprecation policy.

### [Before you begin](#before-you-begin)

-   Request access to the portal and confirm you can sign in.
-   Have your API's OpenAPI specification (3.0 or 3.1) ready in JSON or YAML.
-   Review the [Getting started](https://developer.collectors.com/getting-started) page to register an application and obtain credentials.

### [Need help?](#need-help)

If you can't find what you're looking for, browse the [APIs](https://developer.collectors.com/apis) catalog to see working examples, or contact the API platform team for support.