Skip to content

docs: add api-design.md and link from README Documentation section#450

Open
tobiadewola41-eng wants to merge 1 commit into
stellarkit-lab-devtools:mainfrom
tobiadewola41-eng:docs/api-design-guidelines
Open

docs: add api-design.md and link from README Documentation section#450
tobiadewola41-eng wants to merge 1 commit into
stellarkit-lab-devtools:mainfrom
tobiadewola41-eng:docs/api-design-guidelines

Conversation

@tobiadewola41-eng

Copy link
Copy Markdown

Closes #301

Adds docs/api-design.md as a single reference explaining StellarKit's response
conventions for contributors and API consumers.

Covers:

  • Response envelope (success, data, meta)
  • Pagination shape (request params + meta response fields)
  • Asset format (XLM vs CODE:ISSUER)
  • Timestamp format (ISO 8601 UTC)
  • Amount format (decimal strings, display formatting, stroops)
  • Error shape (HorizonError, ValidationError, PayloadTooLargeError,
    ServerError)

Each section includes a JSON example. The README ## Documentation section is
updated to link the new document alongside the Getting Started Guide.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation & Examples | Write a docs/api-design.md document explaining StellarKit's response envelope and conventions

1 participant