أمثلة تصدير الروابط (JavaScript و PHP)

أمثلة جاهزة لاستدعاء تصدير روابط الاستبيان من تطبيقك. استبدل:

• https://api-cxm.akwad.sa - الرابط الأساسس
• {collector_uuid} - معرف المُجمّع من Collect → API → Details
• {your_token} - رمز الوصول الخارجي

TIP

راجع استجابات التصدير لفهم رموز HTTP والأخطاء.

JavaScript

JavaScript - export links

const apiBase = 'https://api-cxm.akwad.sa';
const collectorUuid = '{collector_uuid}';
const token = '{your_token}';

async function exportSurveyLinks() {
  const response = await fetch(
    `${apiBase}/api/v1/collectors/api/${collectorUuid}/export`,
    {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        Accept: 'application/json',
        'Accept-Language': 'ar',
        'X-External-Access-Token': token,
      },
      body: JSON.stringify({
        recipients: [
          {
            email: 'john1@example.com',
            phone: '+966501234567',
            first_name: 'John',
            last_name: 'Doe',
            variables: { request_number: 'REQ-88421' },
          },
        ],
      }),
    },
  );

  const payload = await response.json();

  if (!response.ok) {
    console.error(payload.message, payload.errors);
    throw new Error(payload.message ?? 'Export request failed');
  }

  return payload.data;
}

exportSurveyLinks()
  .then((data) => {
    for (const row of data.recipients) {
      console.log(row.status, row.survey_link, row.error);
    }
  })
  .catch((error) => console.error(error));

PHP

PHP - export links

<?php

$apiBase = 'https://api-cxm.akwad.sa';
$collectorUuid = '{collector_uuid}';
$token = '{your_token}';

$url = rtrim($apiBase, '/').'/api/v1/collectors/api/'.$collectorUuid.'/export';

$body = json_encode([
    'recipients' => [
        [
            'email' => 'john1@example.com',
            'phone' => '+966501234567',
            'first_name' => 'John',
            'last_name' => 'Doe',
            'variables' => ['request_number' => 'REQ-88421'],
        ],
    ],
], JSON_THROW_ON_ERROR);

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Accept: application/json',
        'Accept-Language: ar',
        'X-External-Access-Token: '.$token,
    ],
    CURLOPT_POSTFIELDS => $body,
]);

$responseBody = curl_exec($ch);
$statusCode = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$payload = json_decode($responseBody, true, 512, JSON_THROW_ON_ERROR);

if ($statusCode < 200 || $statusCode >= 300) {
    throw new RuntimeException($payload['message'] ?? 'Export request failed');
}

foreach ($payload['data']['recipients'] as $row) {
    echo ($row['status'] ?? '').' '.($row['survey_link'] ?? '').PHP_EOL;
}

---

← استجابات التصدير