Skip to main content

SDK Overview

Coming Soon

Official SDKs are planned for Q2 2026. This page previews what's coming.

Planned SDKs​

JavaScript / TypeScript​

npm install @optropic/sdk
import { Optropic } from '@optropic/sdk';

const client = new Optropic({
  apiKey: process.env.OPTROPIC_API_KEY,
});

// Generate a code
const code = await client.codes.generate({
  gtin: '04260799580008',
  serial: 'SN-001',
  batch: 'BATCH-A',
});

// Verify a code
const result = await client.codes.verify({
  url: code.url,
});

console.log(result.verdict); // 'AUTHENTIC'

Python​

pip install optropic
from optropic import Optropic

client = Optropic(api_key=os.environ['OPTROPIC_API_KEY'])

# Generate a code
code = client.codes.generate(
    gtin='04260799580008',
    serial='SN-001',
    batch='BATCH-A'
)

# Verify a code
result = client.codes.verify(url=code.url)
print(result.verdict)  # 'AUTHENTIC'

SDK Features (Planned)​

  • Type-safe: Full TypeScript/Python type definitions
  • Automatic retries: Exponential backoff for transient failures
  • Rate limit handling: Automatic wait and retry on 429
  • Offline verification: Local signature verification
  • Logging: Configurable debug logging

Current Integration​

Until SDKs are released, use the REST API directly:

Beta Access​

Want early access to the SDK beta? Contact sdk@optropic.com with:

  • Your use case
  • Preferred language (JavaScript, Python, other)
  • Expected API volume

Community Libraries​

We welcome community SDK contributions. If you build an SDK wrapper, let us know and we'll list it here.

Contribution Guidelines​

  • Follow our API Reference exactly
  • Include comprehensive tests
  • Document all public methods
  • Handle rate limits and retries gracefully