مستندات API

define( 'LA24_API_ENABLED', true );
define( 'hash_key_jwt_token', 'YOUR_CUSTOM_SECRET_KEY' );
define( 'jwt_auth_expire', 604800 ); // مدت اعتبار توکن به ثانیه، پیش‌فرض ۷ روز

https://yourdomain.com/wp-json/{namespace}/v{version}/{endpoint}

POST /wp-json/core/token

{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "user_email": "admin@yourdomain.com",
  "user_nicename": "admin",
  "user_display_name": "Site Admin"
}

Authorization: Bearer {token}

POST /wp-json/core/token/validate

{
  "code": "jwt_auth_valid_token",
  "data": { "status": 200 }
}

{
  "code": "[jwt_auth] incorrect_password",
  "message": "The password you entered is incorrect.",
  "data": { "status": 403 }
}

curl -X POST https://yourdomain.com/wp-json/core/token \
  -d "username=your_admin_username" \
  -d "password=your_admin_password"

const response = await fetch('https://yourdomain.com/wp-json/core/token', {
  method: 'POST',
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' },
  body: new URLSearchParams({
    username: 'your_admin_username',
    password: 'your_admin_password',
  }),
});

const { token } = await response.json();
console.log(token);

$response = wp_remote_post( 'https://yourdomain.com/wp-json/core/token', array(
    'body' => array(
        'username' => 'your_admin_username',
        'password' => 'your_admin_password',
    ),
) );

$body  = json_decode( wp_remote_retrieve_body( $response ), true );
$token = $body['token'] ?? null;

curl -X GET https://yourdomain.com/wp-json/ums/v1/lead/123 \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."

const response = await fetch('https://yourdomain.com/wp-json/ums/v1/lead/123', {
  method: 'GET',
  headers: { 'Authorization': `Bearer ${token}` },
});

const result = await response.json();
console.log(result);

$response = wp_remote_get( 'https://yourdomain.com/wp-json/ums/v1/lead/123', array(
    'headers' => array(
        'Authorization' => 'Bearer ' . $token,
    ),
) );

$result = json_decode( wp_remote_retrieve_body( $response ), true );

{
  "status": 200,
  "message": "Lead retrieved successfully.",
  "data": {
    "id": 123,
    "display_name": "John Doe",
    "email": "john@example.com",
    "registered_date": "2026-05-01 10:12:00",
    "customer_type": "1",
    "first_name": "John",
    "last_name": "Doe",
    "phone": "+989123456789",
    "phone_numbers": [
      { "tell": "+989123456789", "desc": "", "default": "1" }
    ],
    "gender": "1",
    "job": "Manager",
    "created_by": { "id": 1, "name": "Site Admin" }
  }
}

{
  "status": 200,
  "message": "پیام قابل‌خواندن اختیاری.",
  "data": {}
}

{
  "code": "jwt_auth_invalid_token",
  "message": "Signature verification failed.",
  "data": { "status": 403 }
}

GET /wp-json/sales-opportunity/v1/get-cards?page=2&per_page=25

{
  "status": 200,
  "data": [ /* رکوردهای این صفحه */ ],
  "pagination": {
    "page": 2,
    "per_page": 25,
    "total": 118,
    "total_pages": 5
  }
}

curl -X GET "https://yourdomain.com/wp-json/ums/v1/lead/123" \
  -H "Authorization: Bearer your_token_here"

curl -X GET "https://yourdomain.com/wp-json/sales-opportunity/v1/search-leads?s=john&limit=10" \
  -H "Authorization: Bearer your_token_here"

{
  "status": 200,
  "data": [
    {
      "id": 123,
      "label": "John Doe",
      "name": "John Doe",
      "email": "john@example.com",
      "profile_url": "https://yourdomain.com/panel/profile/?id=123&clue=on",
      "type": "clue"
    }
  ]
}

curl -X POST "https://yourdomain.com/wp-json/ums/v1/lead" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "lead_email": "john@example.com",
    "phone": "+989123456789",
    "customer_type": "1"
  }'

{
  "status": 200,
  "message": "Lead created successfully.",
  "data": {
    "status": true,
    "profile_id": 124,
    "profile_link": "https://yourdomain.com/panel/profile/?id=124",
    "display_name": "John Doe"
  }
}

curl -X PATCH "https://yourdomain.com/wp-json/ums/v1/lead/124" \
  -H "Authorization: Bearer your_token_here" \
  -H "Content-Type: application/json" \
  -d '{ "phone": "+989350000000" }'

{
  "status": 200,
  "message": "Lead updated successfully.",
  "data": {
    "status": true,
    "profile_id": 124,
    "profile_link": "https://yourdomain.com/panel/profile/?id=124",
    "display_name": "John Doe"
  }
}

curl -X DELETE "https://yourdomain.com/wp-json/ums/v1/lead/124" \
  -H "Authorization: Bearer your_token_here"

{
  "status": 200,
  "message": "Lead deleted successfully.",
  "data": { "success": true, "lead_id": 124 }
}

curl -X GET "https://yourdomain.com/wp-json/sales-opportunity/v1/get-cards?so_id=1&page=1&per_page=25&s=john" \
  -H "Authorization: Bearer your_token_here"

curl -X GET "https://yourdomain.com/wp-json/ums/v1/lead/123"

{ "status": 403, "message": "The request cannot be processed." }

{
  "code": "jwt_auth_invalid_token",
  "message": "Expired token",
  "data": { "status": 403 }
}