Заявки з вашого сайту — одразу в CRM

curl -X POST https://api.clubbase.fit/v1/integrations/leads \
  -H "Authorization: Bearer $CLUBBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen | tr 'A-Z' 'a-z')" \
  -d '{
    "displayName": "Приклад API",
    "contact": {
      "type": "email",
      "value": "[email protected]"
    },
    "sourceId": null,
    "note": "Контрольна заявка інтеграції"
  }'

import { randomUUID } from 'node:crypto';

// Ключ — зі змінних середовища, ніколи не з коду сторінки.
const response = await fetch('https://api.clubbase.fit/v1/integrations/leads', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.CLUBBASE_API_KEY}`,
    'Content-Type': 'application/json',
    // Той самий ключ при повторі поверне ту саму заявку, а не другу.
    'Idempotency-Key': randomUUID(),
  },
  body: JSON.stringify({
    "displayName": "Приклад API",
    "contact": {
      "type": "email",
      "value": "[email protected]"
    },
    "sourceId": null,
    "note": "Контрольна заявка інтеграції"
  }),
});

if (!response.ok) {
  const problem = await response.json();
  throw new Error(`${problem.status} ${problem.code}: ${problem.detail}`);
}

const lead = await response.json();

<?php
// Ключ читається з оточення сервера, а не з коду сторінки.
// Idempotency-Key має бути саме UUID: 32 hex-символи без дефісів API відхилить.
$bytes = random_bytes(16);
$bytes[6] = chr(ord($bytes[6]) & 0x0f | 0x40);
$bytes[8] = chr(ord($bytes[8]) & 0x3f | 0x80);
$idempotencyKey = vsprintf('%s%s-%s-%s-%s-%s%s%s', str_split(bin2hex($bytes), 4));

$ch = curl_init('https://api.clubbase.fit/v1/integrations/leads');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    'Authorization: Bearer ' . getenv('CLUBBASE_API_KEY'),
    'Content-Type: application/json',
    'Idempotency-Key: ' . $idempotencyKey,
  ],
  CURLOPT_POSTFIELDS => json_encode([
    'displayName' => "Приклад API",
    'contact' => [
      'type' => "email",
      'value' => "[email protected]",
    ],
    'note' => "Контрольна заявка інтеграції",
  ], JSON_UNESCAPED_UNICODE),
]);
$response = curl_exec($ch);

curl "https://api.clubbase.fit/v1/integrations/leads?limit=20" \
  -H "Authorization: Bearer $CLUBBASE_API_KEY"

curl https://api.clubbase.fit/v1/integrations/leads/$LEAD_ID \
  -H "Authorization: Bearer $CLUBBASE_API_KEY"