المطورون

ابنِ على واجهة ذا اكس سيستم البرمجية

واجهة REST واحدة خلف كل تطبيق في الكتالوج، بمستند OpenAPI 3.1 وويب هوك موقّعة وأكثر من 300 حدث يمكنك الاشتراك فيها. نفس الواجهة التي تعمل عليها مساحة عملك.

افتح المرجع نزّل openapi.json

احصل على مفتاح

افتح الإعدادات ← المطورون في مساحة عملك، أنشئ مفتاح API، وحدد له دورًا (من مشاهد إلى مالك) وقائمة موارد. يُعرض المفتاح كاملًا مرة واحدة فقط — انسخه قبل إغلاق النافذة.

Authorization: Bearer txk_live_51H8f…
X-Company-Id: <معرّف شركتك>

أرسل المفتاح كرمز حامل (bearer) مع كل طلب، مع ترويسة الشركة التي يتبع لها.

هيكل الاستجابة

ترجع كل نقطة نهاية إحدى صيغتين: حمولة ناجحة، أو خطأ منظّم. نقاط القوائم تضيف ترقيم الصفحات.

200

{ "data": { … }, "total": 128, "page": 1, "pageSize": 25 }

4xx

{ "error": { "code": "VALIDATION_ERROR", "message": "quantity must be at least 0", "details": [ … ] } }

جرّبها

طلبان يعملان مع أي شركة: قراءة قائمة، وكتابة مستند.

عرض العملاء

curl https://api.thexsys.com/api/v1/customers \
  -H "Authorization: Bearer txk_live_…" \
  -H "X-Company-Id: <معرّف الشركة>"

إنشاء فاتورة

curl -X POST https://api.thexsys.com/api/v1/invoices \
  -H "Authorization: Bearer txk_live_…" \
  -H "X-Company-Id: <معرّف الشركة>" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_…",
    "date": "2026-09-20",
    "dueDate": "2026-10-20",
    "lines": [{ "description": "استشارات", "quantity": 1, "unitPrice": 500 }]
  }'

ويب هوك

سجّل رابط نقطة نهاية وقائمة أنماط أحداث (حدث، أو عائلة مثل `invoice.*`، أو `*`) من الإعدادات ← المطورون، ويُرسل كل حدث مطابق إليها كـ JSON مع توقيع يمكنك التحقق منه.

تحقق من التوقيع

يحمل كل تسليم ترويسة بالشكل التالي. احسب HMAC-SHA256 لـ "<t>.<الجسم الخام>" بسر نقطة النهاية (`whsec_…`) وقارنه بـ v1 بزمن ثابت.

x-thexsys-signature: t=1758345600,v1=5a8f0e2c…

جدول إعادة المحاولة

يُعاد إرسال التسليم الفاشل (استجابة غير 2xx، أو مهلة 10 ثوانٍ) وفق سلم تصاعدي؛ بعد آخر محاولة يُعتبر ميتًا ويظهر في سجل تسليم نقطة النهاية.

دقيقة واحدة ← 5 دقائق ← 30 دقيقة ← ساعتان ← 12 ساعة

الأحداث

كل عائلة يصدرها النظام، مسحوبة مباشرة من الواجهة. تطابق `*` كل شيء ما عدا سجل التدقيق، عالي الحجم واختياري (`audit.*`).

521 حدث80 عائلة

aftersales
aftersales.agreement.expiringaftersales.claim.overdueaftersales.claim.respondedaftersales.claim.settled+19
agents
agents.action.approvedagents.action.executedagents.action.expiredagents.action.pending+9
analytics
analytics.access.changedanalytics.access.deniedanalytics.access.grantedanalytics.access.revoked+3
التطبيقات
app.disabledapp.enabledapp.installedapp.uninstalled
المواعيد
appointments.bookedappointments.rescheduledappointments.status_changed
تقييم الأداء
appraisals.cycle.closedappraisals.cycle.openedappraisals.feedback.requestedappraisals.goal.achieved+1
الموافقات
approvals.request.approvedapprovals.request.overdueapprovals.request.rejectedapprovals.request.submitted
الحضور
attendance.checked_inattendance.checked_outattendance.day.closedattendance.leave.approved+1
سجل التدقيق
ورشة السيارات
auto-workshop.job.checked_inauto-workshop.job.deliveredauto-workshop.job.readyauto-workshop.job.waiting_parts+1
av
av.boq.frozenav.boq.generatedav.commissioning.failedav.commissioning.passed+11
biometrics
biometrics.attendance.postedbiometrics.device.errorbiometrics.device.recoveredbiometrics.device.registered+9
المدونة
blog.comment.receivedblog.post.publishedblog.subscriber.added
غسيل السيارات
carwash.coupon.redeemedcarwash.job.capturedcarwash.job.completedcarwash.job.flagged+4
cheques
cheques.book.exhaustedcheques.book.lowcheques.customer.holdcheques.deposit.cancelled+22
configurator
configurator.bom.generatedconfigurator.configuration.attachedconfigurator.configuration.savedconfigurator.template.archived+2
الربط والقنوات
connect.channel.errorconnect.menu.publishedconnect.order.acceptedconnect.order.cancelled+7
المقاولات
construction.claim.certifiedconstruction.claim.submittedconstruction.contract.overrunconstruction.dlp.ending+1
إدارة علاقات العملاء
crm.activity.donecrm.lead.convertedcrm.lead.createdcrm.lead.lost+2
المحادثات
discuss.channel.createddiscuss.mentioneddiscuss.message.posted
التجارة الإلكترونية
ecommerce.order.cancelledecommerce.order.confirmedecommerce.order.deliveredecommerce.order.placed+2
التعليم
education.attendance.absenteducation.fee.invoicededucation.fee.overdueeducation.grades.published+1
التعلم الإلكتروني
elearning.certificate.issuedelearning.course.completedelearning.course.publishedelearning.enrolment.created+1
تكامل أنظمة التيار المنخفض
elv.boq.frozenelv.boq.generatedelv.credential.revealedelv.design.approved+13
التسويق بالبريد
email-marketing.campaign.sentemail-marketing.subscriber.subscribedemail-marketing.subscriber.unsubscribed
الموظفون
employees.joinedemployees.status_changed
السجل الطبي
emr.claim.decidedemr.encounter.closedemr.encounter.openedemr.order.resulted
الفعاليات
events.event.closedevents.event.publishedevents.registration.checked_inevents.registration.created
مطالبات المصروفات
expenses.claim.approvedexpenses.claim.pendingexpenses.claim.reimbursedexpenses.claim.rejected+1
الخدمة الميدانية
field-service.work_order.createdfield-service.work_order.dispatchedfield-service.work_order.done
الأسطول
fleet.fine.recordedfleet.fuel.loggedfleet.vehicle.assigned
المنتدى
forum.answer.acceptedforum.reply.publishedforum.topic.pendingforum.topic.published
forwarding
forwarding.agent.agreementExpiringforwarding.agent.settledforwarding.bond.expiringforwarding.consol.built+21
مكتب المساعدة
helpdesk.ticket.assignedhelpdesk.ticket.createdhelpdesk.ticket.repliedhelpdesk.ticket.solved
المستشفى
hospital.admission.createdhospital.admission.dischargedhospital.alert.raisedhospital.discharge.overdue+1
الضيافة
hospitality.booking.cancelledhospitality.booking.checked_inhospitality.booking.checked_outhospitality.booking.created+2
hse
hse.action.raisedhse.action.verifiedhse.doc.acknowledgedhse.doc.issued+16
إنترنت الأشياء
iot.alert.clearediot.alert.raisediot.command.queuediot.device.offline+1
jewelry
jewelry.melt.closedjewelry.order.deliveredjewelry.order.readyjewelry.purchase.paid+3
المعرفة
knowledge.article.flaggedknowledge.article.publishedknowledge.article.review_requestedknowledge.review.due
المحاماة
legal.conflict.flaggedlegal.hearing.outcome_recordedlegal.hearing.scheduledlegal.matter.closed+3
الدردشة المباشرة
livechat.chat.missedlivechat.chat.ratedlivechat.chat.resolvedlivechat.chat.started+2
الولاء
loyalty.coupon.usedloyalty.giftcard.issuedloyalty.giftcard.redeemedloyalty.member.enrolled+3
الصيانة
maintenance.equipment.downmaintenance.equipment.upmaintenance.request.completedmaintenance.request.created
التصنيع
manufacturing.order.cancelledmanufacturing.order.confirmedmanufacturing.order.createdmanufacturing.order.done+2
أتمتة التسويق
marketing.lead.enteredmarketing.lead.hot
المتجر
marketplace.listing.installedmarketplace.listing.publishedmarketplace.review.postedmarketplace.version.submitted
ترحيل البيانات
migration.job.donemigration.job.undone
نماذج الصناعات
model.installed
المنظمات غير الربحية
nonprofit.disbursement.paidnonprofit.donation.pendingnonprofit.donation.receivednonprofit.pledge.due+1
روابط الدفع
payments.link.createdpayments.link.paid
الرواتب
payroll.eos.paidpayroll.run.approvedpayroll.run.calculatedpayroll.run.due+1
الصيدلية
pharmacy.batch.expiringpharmacy.batch.recalledpharmacy.dispensed
التخطيط
planning.shift.assignedplanning.shift.publishedplanning.week.published
دورة حياة المنتج
plm.change.appliedplm.change.approvedplm.change.rejectedplm.change.submitted+1
نقطة البيع
pos.cash.movedpos.refundpos.salepos.session.closed+1
المشاريع
project.createdproject.milestone.reachedproject.status_changedproject.task.created+2
العقارات
property.enquiry.createdproperty.lease.activatedproperty.lease.endedproperty.lease.expiring+2
الجودة
quality.check.createdquality.check.failedquality.check.passedquality.ncr.closed+1
التوظيف
recruitment.application.hiredrecruitment.application.receivedrecruitment.interview.scheduledrecruitment.offer.sent
الإحالات
referrals.referral.duplicatereferrals.referral.hiredreferrals.referral.submittedreferrals.reward.approved+1
التأجير
rental.agreement.cancelledrental.agreement.invoicedrental.agreement.picked_uprental.agreement.reserved+1
منشئ التقارير
reportBuilder.schedule.failedreportBuilder.schedule.sent
المطعم
restaurant.delivery.assignedrestaurant.delivery.statusrestaurant.line.readyrestaurant.line.voided+7
عمليات الأمن
security-ops.assignment.noshowsecurity-ops.incident.createdsecurity-ops.permit.approved
shipping
shipping.booking.createdshipping.booking.cutoffDueshipping.cashup.recordedshipping.cod.collected+20
التوقيع الإلكتروني
sign.envelope.completedsign.envelope.declinedsign.envelope.expiredsign.envelope.sent+3
التسويق بالرسائل
sms-marketing.campaign.sentsms-marketing.contact.unsubscribedsms-marketing.otp.verified
التسويق الاجتماعي
social.inbox.receivedsocial.post.failedsocial.post.published
جداول البيانات
spreadsheet.workbook.sent
storefronts
storefronts.channel.connectedstorefronts.channel.errorstorefronts.channel.quietstorefronts.fulfilment.delivered+14
الاشتراكات
subscriptions.activatedsubscriptions.cancelledsubscriptions.createdsubscriptions.past_due+2
الاستبيانات
surveys.response.completed
الإجازات
time-off.request.approvedtime-off.request.pendingtime-off.request.rejectedtime-off.request.submitted
سجلات الوقت
timesheets.entry.approvedtimesheets.entry.loggedtimesheets.entry.rejectedtimesheets.entry.submitted+1
training
training.competency.addedtraining.enrolment.requestedtraining.gate.blockedtraining.induction.assigned+8
صف السيارات
valet.car.overnightvalet.car.readyvalet.car.requestedvalet.incident.raised+4
الاتصال الصوتي
voip.call.completedvoip.call.dialledvoip.call.missedvoip.call.started
الموقع الإلكتروني
website.domain.verifiedwebsite.form.submittedwebsite.page.publishedwebsite.site.published
واتساب
whatsapp.broadcast.sentwhatsapp.contact.opted_outwhatsapp.conversation.resolvedwhatsapp.message.received+1

المرجع الكامل

كل مسار وطلب ومخطط استجابة، مولّد من نفس المستند الذي تقدمه الواجهة، مع مربع بحث وتسميات ثنائية اللغة.

افتح المرجع نزّل openapi.json

ابنِ تطبيقًا، لا مجرد تكامل

تطبيق ذا اكس سيستم هو بيان (manifest) مع حزمة خادم وويب يُثبَّت في مساحة عمل أي مستأجر: قائمته وصلاحياته وأنواع مستنداته ونصوصه بالعربية والإنجليزية، مشاركًا التأجير والهوية وسجل التدقيق في النواة مع كل تطبيق آخر.

اقرأ دليل مطوري التطبيقات التوثيق

ابنِ على واجهة ذا اكس سيستم البرمجية

عرض العملاء

إنشاء فاتورة

تحقق من التوقيع

جدول إعادة المحاولة

aftersales

agents

analytics

التطبيقات

المواعيد

تقييم الأداء

الموافقات

الحضور

سجل التدقيق

ورشة السيارات

av

biometrics

المدونة

غسيل السيارات

cheques

configurator

الربط والقنوات

المقاولات

إدارة علاقات العملاء

المحادثات

التجارة الإلكترونية

التعليم

التعلم الإلكتروني

تكامل أنظمة التيار المنخفض

التسويق بالبريد

الموظفون

السجل الطبي

الفعاليات

مطالبات المصروفات

الخدمة الميدانية

الأسطول

المنتدى

forwarding

مكتب المساعدة

المستشفى

الضيافة

hse

إنترنت الأشياء

jewelry

المعرفة

المحاماة

الدردشة المباشرة

الولاء

الصيانة

التصنيع

أتمتة التسويق

المتجر

ترحيل البيانات

نماذج الصناعات

المنظمات غير الربحية

روابط الدفع

الرواتب

الصيدلية

التخطيط

دورة حياة المنتج

نقطة البيع

المشاريع

العقارات

الجودة

التوظيف

الإحالات

التأجير

منشئ التقارير

المطعم

عمليات الأمن

shipping

التوقيع الإلكتروني

التسويق بالرسائل

التسويق الاجتماعي

جداول البيانات

storefronts

الاشتراكات

الاستبيانات

الإجازات

سجلات الوقت