تعرف على كيف يمكن لواجهة برمجة التطبيقات الخاصة بتكوين الشركة أن تتيح لمجتمعك إمكانية الوصول إلى تشغيل الشركات ذات المسؤولية المحدودة وC Corps وDAO LLCs بسهولة من سطر الأوامر.

سحب الستار عن واجهة برمجة التطبيقات الخاصة بتكوين الشركة في doola

في هذا المنشور، نريد أن نقدم نظرة خاطفة على عملية التصميم والتفكير وراء الجزء الأول من مفهوم واجهة برمجة التطبيقات (API) الخاص بنا في كل مكان، والذي سنقوم بتوسيع نطاقه خلال الأسابيع والأشهر القادمة!

لماذا بنينا API

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

يعد التركيز القوي على واجهة برمجة التطبيقات (API) في مجال يركز على نجاح العملاء التزامًا بالنسبة لنا. في doola، نريد أن نضع في أيدي عملائنا وشركائنا نفس الأدوات المتوفرة لدينا.

إنشاء واجهة برمجة تطبيقات (API) سهلة الاستخدام

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

يعد GraphQL أحد أدوات التمكين الرئيسية لدينا في هذا المجال، ويرجع أصله إلى Facebook حوالي عام 2015، وقد تم تصميم GraphQL في الأصل لمساعدة عملاء الهاتف المحمول في إجراء استعلامات سريعة ضد ميزات مثل المخطط الزمني لـ Facebook من خلال الاستعلام فقط عن البيانات التي يحتاجها في أي وقت.

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

عادةً ما تتم كتابة واجهات برمجة التطبيقات (الويب) بأسلوب REST الشبيه (نقل الحالة التمثيلية)، REST هو نمط تم تطويره بواسطة رائد الإنترنت Roy Fielding في أوائل العقد الأول من القرن الحادي والعشرين في رسالة الدكتوراه. الأطروحة و"تمتد" بشكل أساسي الويب طبقة مع استمارتنا دلالات.

REST, هاتيواسو RDF جميعهم ينتمون إلى فئة من التكنولوجيا التي تقريبا كان عصرها الذهبي ولكن لم يتم الوفاء بالوعد بأنظمة قابلة للتشغيل البيني عالميًا تعتمد فقط على تبادل البيانات المتفق عليها ومعايير RPC.

في واجهة برمجة التطبيقات ذات النمط REST، سيتم تصميم واجهة برمجة التطبيقات للتكوين على أنها "وضع /الشركات" مع حمولة بيانات تحتوي على الأرجح على بعض "بيانات النموذج" أو، في المناخ التكنولوجي الحالي، على الأرجح مستند JSON. بالنسبة لحالة بسيطة مثل التكوين، فهذا أمر جيد، ولكن الاستعارة يمكن أن تنهار قريبًا، وقد يتم تصميم إلغاء تشكيل شركة، على سبيل المثال، بمعنى HTTP+REST، على أنه استخدام "يمسح" الفعل ضد نفس نقطة النهاية، أو "PATCH /companies/:id بحمولة مثل {isCanceled: true}"فجأة أصبحنا لا نتحدث نفس اللغة التي يتحدث بها أقراننا من أصحاب المصلحة في أعمالنا.

كود GraphQL
حتى عند إنشاء كائنات في GraphQL، يمكنك أن تطلب من الخادم المستجيب حقولًا محددة في الرد.

في "ما بعد / graphql " و"طفره" الأجزاء هي "ضوضاء" لا يمكن تجنبها في واجهة برمجة التطبيقات، ولكن بفضل قوة GraphQL، يمكن للعميل التحقق من النوع والتحقق من صحة "المعاملات" المرسلة، ويمكن استخدام الوثائق التفاعلية القابلة للتصفح مع الإكمال التلقائي للعمل مع واجهة برمجة التطبيقات (API) الخاصة بنا في بيئة تطوير متكاملة (IDE) أسهل. بعد إرسال الطلب يعرف العميل فوراً، في المثال أعلاه، إذا كان ناجحاً أم لا، وفي حال كان ناجحاً، يمكنه تحديد سمات الشركة على الفور. "شركات" من الواضح أن واجهة برمجة التطبيقات (API) تحتوي على الكثير من السمات، وبفضل المستندات المرجعية مرة أخرى، يمكن للأفراد والعملاء وشركائنا وأنفسنا بناء واجهات منخفضة وعالية الدقة بالإضافة إلى الأتمتة أو واجهات المستخدم أو أي حالة استخدام.

GraphQL هي التكنولوجيا التي تسمح لنا بتكييف تقنيتنا مع الحلول في العالم الحقيقي بطريقة مألوفة، في GraphQL تعتبر هذه الأنواع من حالات الاستخدام طبيعية:

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

المستقبل هو doola API

نحن نقوم بالكثير من الأشياء المثيرة للاهتمام في واجهة برمجة التطبيقات (API) الخاصة بنا، ويعد GraphQL أداة تمكين لنا لمواصلة الابتكار. سنكتب المزيد والمزيد عن واجهة برمجة التطبيقات (API) الخاصة بنا، على سبيل المثال، حول تصميم خدمة المصادقة والترخيص اللامركزية، وتصميم نموذج البيانات لدينا، وأيضًا علاقتنا مع AWS AppSync، وكيف يكون ذلك عامل تمكين لفرق الهندسة متعددة الوظائف. للحفاظ على السرعة في بيئة تقنية متعددة اللغات.

تعد واجهة برمجة تطبيقات تكوين الشركة والنموذج المعياري الداعم مجرد الأماكن الأولى التي نختار الذهاب إليها!

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

ابدأ مشروع أحلامك وحافظ على توافقه بنسبة 100%

حول فكرة أحلامك إلى مشروع أحلامك.