Atlassian REST API Policy

Atlassian

API Lifecycle

Governance

How to ensure API governance (advertise, consistency, …)

Updates and Versioning

How to handle API updates and versioning

Collection Resources

Pagination

How to retrieve a range of resources in a collection

HTTP Protocol

HTTP Headers

How to use standard or custom HTTP headers

Miscellaneous

Developer experience

How to take care of developer experience (DX)

Rate limiting

How to provide information about how many calls a consumer can do

Resources

URL format

How to design URLs