الانتقال إلى المحتوى الرئيسي

كيفية الوصول إلى واجهة برمجة تطبيقات المحور 1 سي وحل مشكلة الوصول المحظور إلى إيدو

1 ج هي منصة شائعة لأتمتة العمليات التجارية. في السنوات الأخيرة ، المزيد والمزيد من المنظمات قد تم استخدام مركز ج 1 لتبادل الوثائق والمعلومات مع الشركاء. ومع ذلك ، في بعض الأحيان هناك مشاكل مع الوصول إلى التبادل الإلكتروني للبيانات (إدارة الوثائق الإلكترونية) من خلال محور أبي 1 ج.

قد يكون سبب حظر الوصول إلى التبادل الإلكتروني للبيانات عدم تطابق بيانات الاعتماد أو تكوين واجهة برمجة تطبيقات غير صحيح. لحل هذه المشكلة ، تحتاج إلى التأكد من أن لديك بيانات الاعتماد الصحيحة وأن واجهة برمجة التطبيقات قد تم تكوينها بشكل صحيح.

الخطوة 1: تأكد من أن لديك بيانات الاعتماد الصحيحة.

تأكد من إدخال عنوان الخادم واسم المستخدم وكلمة المرور بشكل صحيح. إذا كانت لديك الفرصة ، فقم بمقارنة هذه البيانات بالحساب الذي تستخدمه للوصول إلى واجهة الويب 1 سي هاب.

إذا كانت لديك شكوك حول صحة بيانات الاعتماد ، فاتصل بمسؤول المحور 1 سي أو الدعم الفني. سيكونون قادرين على مساعدتك في التحقق من صحة بيانات الاعتماد الخاصة بك وتوضيحها.

  1. التسجيل في نظام المحور 1 ج
  2. إنشاء مفتاح واجهة برمجة التطبيقات وحفظه
  3. استخدام مفتاح واجهة برمجة التطبيقات للترخيص
  4. الشروع في العمل مع 1 سي هاب أبي
  5. نقل البيانات عبر واجهة برمجة التطبيقات
  6. حل مشكلة حظر الوصول إلى إيدو
  7. التحقق من حالة الطلب في واجهة برمجة التطبيقات
  8. تلقي استجابة من واجهة برمجة التطبيقات ومعالجتها

التسجيل في نظام المحور 1 ج

للوصول إلى واجهة برمجة تطبيقات 1 سي هاب وحل مشكلة الوصول المحظور إلى التبادل الإلكتروني للبيانات ، يجب عليك إكمال عملية التسجيل في النظام. يوفر التسجيل فرصة لاستخدام وظائف مركز 1 سي ، بما في ذلك القدرة على تبادل المستندات الإلكترونية مع الشركاء.

للتسجيل في نظام المحور ج 1 ، اتبع الخطوات التالية:

  1. انتقل إلى الموقع الرسمي لنظام المحور 1 سي.
  2. في الصفحة الرئيسية ، انقر فوق الزر "تسجيل".
  3. املأ نموذج التسجيل مع تحديد التفاصيل الخاصة بك:
الميدانالوصف
الاسمأدخل اسمك
اللقبأدخل اسمك الأخير
البريد الإلكترونيأدخل عنوان بريدك الإلكتروني
كلمة المرورأدخل كلمة المرور للوصول إلى النظام

بعد ملء جميع حقول النموذج ، انقر فوق الزر" تسجيل".

بعد فترة ، سيتم إرسال بريد إلكتروني للتأكيد إلى عنوان البريد الإلكتروني الذي قدمته. افتح البريد الإلكتروني واتبع التعليمات لتأكيد التسجيل.

بعد تأكيد تسجيلك ، ستتمكن من الوصول إلى نظام 1 سي هاب وستكون قادرا على البدء في استخدام وظائفه ، بما في ذلك الوصول إلى واجهة برمجة التطبيقات والقدرة على تبادل المستندات الإلكترونية مع الشركاء.

إنشاء مفتاح واجهة برمجة التطبيقات وحفظه

مفتاح واجهة برمجة التطبيقات هو معرف فريد يستخدم للمصادقة والترخيص عند العمل مع واجهة برمجة تطبيقات المحور 1 سي. للوصول إلى واجهة برمجة التطبيقات وحل مشكلة الوصول المحظور إلى التبادل الإلكتروني للبيانات ، تحتاج إلى إنشاء مفتاح واجهة برمجة التطبيقات وحفظه.

  1. انتقل إلى موقع 1 سي هاب وقم بتسجيل الدخول إلى حسابك.
  2. في حسابك الشخصي ، ابحث عن قسم الإعدادات أو الملف الشخصي حيث يمكنك إنشاء مفتاح واجهة برمجة التطبيقات.
  3. انقر فوق الزر" إنشاء مفتاح " أو زر مشابه.
  4. سيتم إنشاء مفتاح واجهة برمجة التطبيقات تلقائيا. تأكد من إنشاء المفتاح وفقا لمتطلبات الأمان (الطول والتعقيد).
  5. احفظ مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه في مكان آمن ومأمون. يوصى باستخدام كلمة المرور في مدير كلمات المرور لحفظها.

بعد إنشاء مفتاح واجهة برمجة التطبيقات وحفظه ، يمكنك استخدامه في الطلبات إلى واجهة برمجة تطبيقات المحور للوصول إلى وظائف مختلفة ، بما في ذلك حل المشكلات المتعلقة بالوصول المحظور الموجود بالفعل إلى التبادل الإلكتروني للبيانات.

مثال على طلب إلى واجهة برمجة تطبيقات المحور باستخدام مفتاح واجهة برمجة التطبيقات

ملاحظة: راجع وثائق مركز واجهة برمجة التطبيقات للحصول على معلومات مفصلة حول إمكانيات وميزات العمل مع مفاتيح واجهة برمجة التطبيقات ، بالإضافة إلى تنسيقات الطلبات والردود.

استخدام مفتاح واجهة برمجة التطبيقات للترخيص

للوصول إلى واجهة برمجة تطبيقات 1 سي هاب وحل مشكلة الوصول المحظور إلى التبادل الإلكتروني للبيانات ، يجب عليك استخدام مفتاح واجهة برمجة التطبيقات للحصول على إذن.

مفتاح واجهة برمجة التطبيقات هو سلسلة فريدة من الأحرف يتم إصدارها للمستخدم للتعرف عليها والسماح بالوصول إلى وظائف وبيانات معينة من خلال واجهة برمجة التطبيقات. يسمح استخدام مفتاح واجهة برمجة التطبيقات لمحور 1 سي بالتحكم في الوصول وضمان الأمان.

للحصول على مفتاح واجهة برمجة التطبيقات ، اتبع الخطوات التالية:

  1. سجل في 1 ج المحور وإنشاء حساب.
  2. قم بتسجيل الدخول إلى الحساب الذي تم إنشاؤه وانتقل إلى قسم إعدادات الملف الشخصي.
  3. في إعدادات الملف الشخصي ، ابحث عن قسم" مفتاح واجهة برمجة التطبيقات " وقم بإنشاء مفتاح جديد.
  4. انسخ مفتاح واجهة برمجة التطبيقات المستلم واحفظه في مكان آمن.

بعد استلام مفتاح واجهة برمجة التطبيقات للترخيص ، يجب استخدامه لكل طلب إلى واجهة برمجة تطبيقات المحور 1 سي. للقيام بذلك ، أضف رأس "التفويض" إلى طلب هتب وقم بتمرير قيمة مفتاح واجهة برمجة التطبيقات فيه.

مثال على استخدام مفتاح واجهة برمجة التطبيقات للترخيص:

  • عنوان الموقع: https://api.1c-hub.com/api/v1/documents
  • طريقة هتب: الحصول على
  • العنوان: إذن: حامل

بعد الحصول على إذن ناجح باستخدام مفتاح واجهة برمجة التطبيقات ، ستتمكن من الوصول إلى الوظائف والبيانات المطلوبة من خلال واجهة برمجة تطبيقات المحور 1 سي ، مما يحل مشكلة الوصول المحظور إلى التبادل الإلكتروني للبيانات.

الشروع في العمل مع 1 سي هاب أبي

1 سي هاب هي خدمة تم تطويرها بواسطة 1 سي ، والتي تتيح لك دمج الأنظمة والخدمات المختلفة مع برنامج 1 سي:شركة. إحدى الميزات التي يوفرها محور 1 سي هي واجهة برمجة التطبيقات التي تسمح بتبادل البيانات بين الأنظمة الخارجية وبرنامج 1 سي:الشركة.

لبدء العمل مع واجهة برمجة تطبيقات المحور 1 سي ، تحتاج إلى إكمال الخطوات التالية:

  1. سجل في خدمة المحور 1 ج.
  2. قم بإنشاء تطبيق للوصول إلى واجهة برمجة التطبيقات.
  3. الحصول على مفتاح أبي للعمل مع التطبيق الخاص بك.

1. للتسجيل في خدمة مركز 1 سي ، انتقل إلى الموقع الرسمي واملأ نموذج التسجيل.

2. بعد التسجيل الناجح ، تحتاج إلى إنشاء تطبيق جديد للوصول إلى واجهة برمجة التطبيقات. للقيام بذلك ، انتقل إلى الحساب الشخصي لمركز 1 سي وحدد قسم "تطبيقاتي". ثم انقر فوق الزر" إنشاء تطبيق".

3. في عملية إنشاء التطبيق ، يجب عليك تحديد الاسم والوصف والمعلومات الضرورية الأخرى. سيطلب منك أيضا تحديد نوع التطبيق (تطبيق الويب أو تطبيق الخادم أو تطبيق الهاتف المحمول).

4. بعد إنشاء التطبيق ، سيتم تزويدك بمفتاح واجهة برمجة التطبيقات. سيتم استخدام هذا المفتاح لمصادقة طلباتك وتخويلها إلى واجهة برمجة تطبيقات المحور 1 سي. قد يتم تزويدك أيضا بمفاتيح ومعلمات أخرى ، اعتمادا على نوع التطبيق المحدد.

5. يمكنك الآن استخدام مفتاح واجهة برمجة التطبيقات المستلم لإرسال الطلبات إلى واجهة برمجة تطبيقات محور 1 سي وتلقي البيانات من برنامج 1 سي:الشركة. للقيام بذلك ، تحتاج إلى إنشاء طلب هتب باستخدام مفتاح أبي الخاص بك وإرساله إلى عنوان محور أبي 1 ج.

طلب مثال:

الطريقةرابطالمعلمات
الحصول علىhttps://api.1c-hub.com/api/v1/call
  • أبي_كي: مفتاح أبي الخاص بك
  • الطريقة: أبي
  • معلمات اسم الأسلوب: معلمات الطلب

6. بعد إرسال الطلب ، ستتلقى ردا من واجهة برمجة تطبيقات المحور 1 سي مع البيانات اللازمة. قد يعتمد تنسيق الاستجابة على طريقة واجهة برمجة التطبيقات التي تختارها ونوع البيانات التي تطلبها.

وبالتالي ، بعد أن بدأت العمل مع واجهة برمجة تطبيقات 1 سي هاب ، يمكنك دمج أنظمة مختلفة مع برنامج 1 سي:المؤسسة وحل مشكلة حظر الوصول إلى إدارة الوثائق الإلكترونية (التبادل الإلكتروني للبيانات).

نقل البيانات عبر واجهة برمجة التطبيقات

واجهة برمجة التطبيقات (واجهة برمجة التطبيقات) هي مجموعة من الأساليب والوظائف التي تسمح للبرامج والخدمات المختلفة بالتفاعل مع بعضها البعض.

يسمح لك نقل البيانات عبر واجهة برمجة التطبيقات بأتمتة وتبسيط عملية تبادل المعلومات بين الأنظمة المختلفة.

يوفر 1 سي هاب واجهة برمجة التطبيقات الخاصة به ، والتي تتيح لك الوصول إلى وظائف وميزات النظام الأساسي المختلفة.

للوصول إلى واجهة برمجة تطبيقات المحور 1 سي ، اتبع الخطوات التالية:

  1. سجل على بوابة المحور 1 ج واحصل على مفتاح واجهة برمجة التطبيقات.
  2. إنشاء طلبات أبي باستخدام أساليب هتب (جيت ، بوست ، بوت ، حذف) وتمرير المعلمات اللازمة.
  3. الحصول على استجابة من أبي في شكل جسون أو شمل ومعالجة البيانات المستلمة.

لحل مشكلة الوصول المحظور إلى التبادل الإلكتروني للبيانات من خلال واجهة برمجة تطبيقات 1 سي هاب ، يمكنك استخدام التوصيات التالية:

  1. تأكد من أن لديك مفتاح واجهة برمجة التطبيقات الصحيح والوصول إلى الوظائف والخدمات المناسبة.
  2. تحقق من صحة طلبات واجهة برمجة التطبيقات والمعلمات المرسلة.
  3. في حالة وجود أخطاء أو مشاكل ، اتصل بخدمة دعم المحور 1 ج للحصول على مساعدة إضافية.

نتيجة لذلك ، يتيح لك نقل البيانات عبر واجهة برمجة التطبيقات أتمتة تبادل المعلومات وتحسين كفاءة العمل مع نظام المحور 1 سي.

قبل استخدام واجهة برمجة التطبيقات ، يوصى بالتعرف على وثائق محور 1 سي من أجل استخدام الوظائف والميزات المتاحة بشكل صحيح.

حل مشكلة حظر الوصول إلى التبادل الإلكتروني للبيانات

يواجه العديد من مستخدمي محور 1 سي مشكلة في الوصول إلى وحدة إيدو (إدارة المستندات الإلكترونية). في بعض الحالات ، عند محاولة فتح هذه الوحدة ، تظهر للمستخدم رسالة حول رفض الوصول.

قد تكون الأسباب المحتملة لمشكلة الوصول المقيد كما يلي:

  • ليس لدى المستخدم حقوق وصول كافية;
  • مشاكل في ترخيص وحدة إيدو;
  • عدم توافق 1 ج المحور وإصدارات وحدة إيدو;
  • مشاكل فنية على جانب الخادم;

لحل مشكلة الوصول المحظور إلى وحدة التبادل الإلكتروني للبيانات في محور 1 ج ، يمكنك اتخاذ الخطوات التالية:

  1. تحقق مما إذا كان المستخدم لديه حقوق الوصول اللازمة. للقيام بذلك ، اتصل بمسؤول النظام وتأكد من أن المستخدم لديه الأذونات اللازمة.
  2. تحقق من الترخيص لاستخدام وحدة إيدو. إذا لم يتم شراء الترخيص أو انتهت صلاحيته ، فيجب عليك الاتصال ببائع البرنامج وشراء الترخيص أو تجديده.
  3. تحقق من توافق إصدارات المحور 1 ج ووحدة إيدو. في حالة حدوث مشكلة بعد تحديث البرنامج أو تثبيته ، فأنت بحاجة إلى التأكد من أن الإصدارات متوافقة ، وإذا لزم الأمر ، قم بتحديث المكونات ذات الصلة أو إعادة تثبيتها.
  4. اتصل بمسؤول ملقم محور ج 1 أو بائع البرنامج إذا لم يكن لديك حقوق الوصول الإدارية. قد تكون المشكلات الفنية على جانب الخادم هي سبب رفض الوصول.

إذا كانت مشكلة الوصول المحظور إلى وحدة التبادل الإلكتروني للبيانات في محور 1 سي ناتجة عن أحد الأسباب المذكورة ، فإن اتباع هذه الخطوات سيساعد في حلها.

ومع ذلك ، إذا لم يتم حل المشكلة بعد إكمال جميع هذه الخطوات ، فمن المستحسن الاتصال بأخصائي مركز 1 سي أو بائع برامج لتلقي المساعدة المؤهلة في حل هذه المشكلة.

التحقق من حالة الطلب في واجهة برمجة التطبيقات

لتلقي البيانات من خلال واجهة برمجة تطبيقات المحور 1 سي ، بعد إرسال طلب ، تحتاج إلى التحقق من حالة الطلب والحصول على النتيجة. للقيام بذلك ، استخدم طريقة الحصول على / الحالات/{معرف الحالة}.

للتحقق من حالة الطلب ، تحتاج إلى معرفة معرفه. يمكنك الحصول على هذا المعرف عند إرسال طلب لإنشاء مهمة جديدة في واجهة برمجة التطبيقات.

للتحقق من حالة الطلب ، اتبع الخطوات التالية:

  1. قم بإنشاء طلب الحصول على العنوان أعلاه عن طريق استبدال معرف الطلب المطلوب بدلا من {معرف الحالة}.
  2. إرسال طلب جيت إلى 1 سي هاب أبي.
  3. احصل على رد من واجهة برمجة التطبيقات بمعلومات حول حالة الطلب.
  4. تحليل الاستجابة المستلمة لراحة العمل مع المعلومات.

في الاستجابة من واجهة برمجة التطبيقات ، يمكنك الحصول على المعلومات التالية حول حالة الطلب:

  • معرف-معرف حالة الطلب;
  • النوع - نوع الطلب;
  • الحالة-الحالة الراهنة للطلب;
  • تم إنشاء الطلب في التاريخ والوقت;
  • محدث-تاريخ ووقت آخر تحديث للطلب;
  • النتيجة-رابط إلى نتيجة تنفيذ الاستعلام;
  • رسالة خطأ-رسالة خطأ إذا حدثت أثناء تنفيذ الطلب;
  • التقدم — التقدم المحرز في تنفيذ الطلب.

بعد تلقي معلومات حول حالة الطلب ، يمكنك تحديد ما إذا كان الطلب قد اكتمل بنجاح أو حدث خطأ. في حالة حدوث خطأ ، سيحتوي حقل رسالة الخطأ على رسالة تصف المشكلة.

ثم يمكنك استخدام البيانات المستلمة لمزيد من المعالجة والتحليل لنتائج الاستعلام. على سبيل المثال ، بناء على حالة الطلب ، يمكنك تحديد ما إذا كنت تريد إعادة إرسال الطلب أو تنفيذ إجراءات أخرى.

وبالتالي ، يعد التحقق من حالة الطلب جزءا مهما من العمل مع واجهة برمجة تطبيقات المحور 1 سي. يسمح لك بالحصول على معلومات حول الوضع الحالي للطلب وتحديد نجاح تنفيذه.

تلقي استجابة من واجهة برمجة التطبيقات ومعالجتها

يعد تلقي استجابة من واجهة برمجة تطبيقات المحور 1 سي مرحلة مهمة من التفاعل مع هذه الخدمة. قد تحتوي الاستجابة على معلومات مهمة حول حالة الطلب والنتيجة نفسها.

واحدة من الطرق للحصول على رد من أبي هو إرسال طلب باستخدام طريقة جيت. سيؤدي الرد على هذا الطلب إلى إرجاع المعلومات المطلوبة أو رسالة خطأ.

لمعالجة الاستجابة من واجهة برمجة تطبيقات المحور 1 سي ، من الضروري تحديد البيانات المتاحة وبأي شكل يتم إرجاعها. للقيام بذلك ، يمكنك قراءة وثائق واجهة برمجة التطبيقات أو الاتصال بمطوري الخدمة.

يمكن معالجة الاستجابة المستلمة من واجهة برمجة التطبيقات بطرق مختلفة:

  • .
  • .
  • معالجة الأخطاء. إذا تم إرجاع رسالة خطأ في الاستجابة ، فمن الضروري معالجتها واتخاذ التدابير المناسبة. على سبيل المثال ، يمكنك عرض رسالة خطأ على الشاشة أو كتابتها إلى السجل.

عند معالجة استجابة من واجهة برمجة تطبيقات المحور 1 سي ، من الضروري مراعاة مشاكل الاتصال المحتملة أو معلمات الطلب غير الصحيحة أو المواقف الأخرى التي قد تؤدي إلى استجابة أو خطأ غير صحيح.

قد تختلف معالجة الاستجابة من واجهة برمجة تطبيقات المحور 1 سي اعتمادا على الحالة المحددة ، لذلك من المهم مراعاة تفاصيل كل طلب وضبط المعالجة وفقا لها.