المكتبات والتكاملات

يمكن استهلاك Omdaa API مباشرة عبر HTTP أو من خلال مكتبات جاهزة يتم توفيرها للغات وأطر عمل مختلفة. يوضح هذا القسم الشكل المقترح للمكتبات الرسمية مثل omdaa-php و omdaa-node و omdaa-laravel.

استخدام مباشر عبر JavaScript

const response = await fetch("https://omdaa.com/api/v1/messages/send-text", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    sessionId: "your-session-id",
    to: "966xxxxxxxxx",
    message: "مرحباً من Omdaa API"
  })
});

مكتبة Node.js

الحزمة الرسمية لـ Node.js و TypeScript متوفرة على npm. التثبيت:

npm install omdaa-api-client

مثال استخدام:

const { OmdaaClient } = require('omdaa-api-client');
const client = new OmdaaClient({ apiKey: 'YOUR_API_KEY' });
const res = await client.messages.sendText({
  sessionId: 'your-session-id',
  to: '966xxxxxxxxx',
  message: 'مرحباً من Omdaa API'
});

الحزمة على npm ← omdaa-api-client

مكتبة PHP

التثبيت: composer require omdaa/omdaa-php

$client = new \Omdaa\Api\OmdaaClient("YOUR_API_KEY");
$client->messages()->sendText(["sessionId"=>"default","to"=>"966xxxxxxxxx","message"=>"مرحبا"]);

مكتبة Python

التثبيت: pip install omdaa-api-client

from omdaa import OmdaaClient
client = OmdaaClient("YOUR_API_KEY")
client.messages.send_text({"sessionId":"default","to":"966xxxxxxxxx","message":"مرحبا"})

مكتبة Go

التثبيت: go get github.com/omdaapi/omdaa-go

client := omdaa.NewOmdaaClient("YOUR_API_KEY", "")
client.Messages.SendText(map[string]interface{}{"sessionId":"default","to":"966xxxxxxxxx","message":"مرحبا"})

Laravel

التثبيت: composer require omdaa/omdaa-laravel ثم إعداد OMDAA_API_KEY في .env

use Omdaa; Omdaa::messages()->sendText(["sessionId"=>"default","to"=>"966xxxxxxxxx","message"=>"مرحبا"]);

جميع المكتبات تدعم نفس موارد الـ API: الرسائل، الجلسات، الويب هوكس، القوالب، المجدولة، الجماعية، جهات الاتصال، المجموعات، المحادثات، وغيرها. npm: omdaa-api-client.