البدء مع API في GetAPI.ONE: مفتاح API والطلب الأول

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

ابدأ من هنا

لبدء استخدام GetAPI.ONE، أنشئ حسابًا واختر نموذجًا ونقطة نهاية يدعمها، ثم أنشئ مفتاح API. هل لديك مفتاح بالفعل؟ انتقل مباشرة إلى مثال Python أو Node.js أدناه. تحقّق من الأسعار الحالية قبل إرسال الطلبات.

قبل البدء

استخدم النطاق الرسمي https://www.getapi.one وبريدًا تستطيع الوصول إليه للتحقق.
قرر ما إذا كنت ستقوم بتوصيل Codex CLI، أو هدف Codex متوافق من خلال CCSwitch، أو عميل API الخاص بك.
جهّز مدير كلمات مرور خاصًا أو مخزن متغيرات بيئة. لا تلصق مفتاحًا حقيقيًا في بلاغ عام أو صورة أو مستودع.

1. إنشاء حسابك وفتحه

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

2. فحص الرصيد والنقطة والنموذج

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

3. إنشاء مفتاح محدود النطاق

افتح مفاتيح API واختر إنشاء مفتاح، وسمّه بما يحدد العميل أو المشروع.
اختر المجموعة المطلوبة وصلاحية محددة وحصة مناسبة. وسّع القيود المتقدمة فقط عندما تفهم الوصول المطلوب.
احفظ المفتاح وانسخه من القائمة إلى مخزنك الخاص. يحتفظ GetAPI.ONE بعنصر قابل للإدارة ويمكنك نسخه لاحقًا.

4. توصيل عميل واحد

استخدم المسار الملائم لعميلك فقط. يستخدم مزود Codex المخصص Responses wire API والعنوان https://www.getapi.one/v1. يجب أن يستخدم برنامج API مباشر النقطة المحددة المعلنة بدل إلحاق مسارات عشوائيًا.

5. التحقق والمتابعة

النجاح يعني استلام العميل استجابة صالحة وتسجيل وحدة GetAPI.ONE للطلب. فحص الصياغة المحلي وحده ليس نجاح استدعاء فعلي.
مع 401 انسخ مفتاح ONE مجددًا وتحقق من تفعيله واقترانه بعنوان ONE. مع 404 تحقق من النقطة الدقيقة أو أساس /v1 المتوقع.
عند غياب النموذج اختر نموذجًا متاحًا للمجموعة ومتوافقًا مع النقطة. لأخطاء الحصة أو المعدل أو الشبكة أو المصدر الأعلى، احفظ الوقت ومعرف الطلب قبل التشخيص.