API Reference

curl -X GET "https://api.yanipay.com/v1/wallets" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

import { getCurrentUser } from '@/lib/auth';

export async function GET() {
  // Unified JWT authentication
  const authResult = await getCurrentUser();

  if (!authResult.success || !authResult.user) {
    return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
  }

  const { userId, email } = authResult.user;
  // Continue with authenticated operations...
}

// Server Component — no 'use client' needed
import { getCurrentUser } from '@/lib/auth';
import { apiGet } from '@/lib/api/client';

interface WalletBalance {
  id: string;
  balance: number; // in cents
  currency: string;
}

export default async function WalletPage() {
  const auth = await getCurrentUser();

  if (!auth.success || !auth.user) {
    redirect('/auth/signin');
  }

  // Typed API call — handles 401 redirect and errors automatically
  const wallet = await apiGet<WalletBalance>('/api/wallets/balance');
  const formattedBalance = (wallet.balance / 100).toFixed(2);

  return (
    <div>
      <h1>Balance : {formattedBalance} {wallet.currency}</h1>
    </div>
  );
}

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 598
X-RateLimit-Reset: 1706896800
Retry-After: 60 (only when rate limited)

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Wallet balance is insufficient for this transaction",
    "details": {
      "required": "100.00",
      "available": "50.00",
      "currency": "YANI"
    },
    "request_id": "req_abc123xyz"
  }
}

import { createHmac, timingSafeEqual } from 'crypto';

export function verifyYaniWebhook(
  rawBody: string,
  signature: string,
  secret: string,
): boolean {
  const expected = createHmac('sha256', secret)
    .update(rawBody, 'utf8')
    .digest('hex');
  const a = Buffer.from(expected, 'hex');
  const b = Buffer.from(signature, 'hex');
  return a.length === b.length && timingSafeEqual(a, b);
}

// Express handler
app.post('/yanipay-webhook', (req, res) => {
  const sig = req.header('X-Yani-Signature');
  const event = req.header('X-Yani-Event');
  if (!sig || !verifyYaniWebhook(req.rawBody, sig, process.env.YP_WH_SECRET!)) {
    return res.status(401).end();
  }
  // event ∈ { 'job-done', 'job-failed', 'share-received' }
  console.log(event, req.body);
  res.status(204).end();
});

# Servir le fichier OpenAPI et lancer Swagger UI
docker run -p 8080:8080 \
  -e SWAGGER_JSON_URL=/api/openapi-v1.yaml \
  swaggerapi/swagger-ui

# Accéder à l'interface
open http://localhost:8080

# Valider la spec avec Spectral (recommandé)
npx @stoplight/spectral-cli lint docs/api/openapi-v1.yaml

# Ou avec swagger-cli
npx @apidevtools/swagger-cli validate docs/api/openapi-v1.yaml