Skip to content

Create language-specific examples #1

Description

@francescobianco

Summary

The repository currently provides only cURL examples. To improve developer adoption and reduce integration time, we should provide ready-to-run examples in the most commonly used programming languages and API tooling ecosystems.

Proposed languages and tools

Create example folders for:

Language / Tool Folder
cURL examples/curl
PHP examples/php
JavaScript (Node.js) examples/javascript
TypeScript examples/typescript
Python examples/python
Java examples/java
C# (.NET) examples/csharp
Go examples/go
Ruby examples/ruby
Rust examples/rust
Bash examples/bash
Postman examples/postman

Example coverage

Each language should include examples for:

  • Authentication using HTTP Basic Auth
  • Generate a token
  • Retrieve token details
  • Update token limits
  • Refresh a token
  • List wallet transactions
  • Retrieve usage statistics
  • Inspect subscriptions
  • Inspect callback logs
  • Error handling examples

Acceptance criteria

  • A dedicated folder exists for each language/tool listed above.
  • Every example is self-contained and runnable.
  • Credentials are loaded from environment variables.
  • Each folder contains a README with execution instructions.
  • Examples are aligned with the current OAuth V2 API specification.
  • CI validates that example snippets remain synchronized with the API documentation.

Additional notes

Priority should be given to:

  1. PHP
  2. JavaScript
  3. TypeScript
  4. Python
  5. Java
  6. C#

These languages are expected to cover the majority of API consumers and provide the highest immediate value.

Metadata

Metadata

Labels

documentationImprovements or additions to documentationenhancementNew feature or request

Type

Fields

No fields configured for Task.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions