رفتن به محتوای اصلی

جستجو

برای جستجو در مقاله‌های راهنما، یک کلمه یا پرسش تایپ کنید.

چگونه یک کلید API بسازم؟

در این گزارش

مکان: تنظیمات ← پیشرفته ← اتصال برنامه‌های دیگر

این صفحه را باز کنید: admin.<your-site>/settings/integrations (به جای <your-site> آدرس سایت خود را بگذارید). اگر آن را در منو نمی‌بینید، نمایش همه تنظیمات را در صفحهٔ تنظیمات روشن کنید.

پیش‌نیازها

  • فقط مالک سایت می‌تواند کلید بسازد.

مراحل انجام کار

  1. تنظیمات → پیشرفته → اتصال به برنامه‌های دیگر → کلیدهای API را باز کنید.
  2. ایجاد کلید را بزنید.
  3. یک نام وارد کنید، مثلاً «وب‌سایت همکار».
  4. زیر چه کارهایی می‌تواند انجام دهد؟؟ مواردی را که نیاز است علامت بزنید:
    • خواندن خبرها: داستان‌های منتشرشده، نه متن‌های پولی.
    • خواندن کامل متن‌های پولی: همچنین متن کامل داستان‌های پولی.
    • ارسال پیش‌نویس‌ها: افزودن داستان‌ها به شکل پیش‌نویس. هیچ‌چیز بدون تیم شما منتشر نمی‌شود.
    • ارسال عکس‌ها: افزودن عکس‌ها به کتابخانهٔ چندرسانه‌ای از یک آدرس وب.
    • خواندن بخش‌ها و برچسب‌ها.
    • خواندن آمار بازدید: بازدید داستان‌ها و مجموع بازدیدکنندگان.
    • خواندن گزارش‌های مالی: فقط مجموع‌ها، هرگز خوانندگان.
  5. اختیاری: تاریخ انقضا، فقط از این آدرس‌ها (یکی در هر خط، تا ۲۰ عدد)، درخواست در دقیقه (۱ تا ۶۰۰) و درخواست در روز (۱ تا ۱,۰۰۰,۰۰۰) را تنظیم کنید.
  6. ایجاد کلید را بزنید.
  7. کلید را از کادر کپی کنید. این تنها باری است که آن را می‌بینید. ذخیره کردم را بزنید.
  8. کلید را به برنامهٔ دیگر بدهید. برنامه آن را در هدر "Authorization: Bearer" ارسال می‌کند.

نکات مهم

  • این فهرست برای هر کلید، نام، دسترسی‌ها، آخرین استفاده، انقضا و وضعیت: فعال، منقضی‌شده یا متوقف شد را نشان می‌دهد.
  • کلید جدیدی ساخته شود؟ یک کلید را جایگزین می‌کند. کلید قبلی تا مدتی که انتخاب می‌کنید فعال می‌ماند، یا اگر احتمال لو رفتن آن وجود دارد اکنون متوقف شود را انتخاب کنید.
  • توقف کلید بلافاصله همهٔ درخواست‌های آن کلید را رد می‌کند. نمی‌توانید این کار را لغو کنید. برای اجازه دادن دوباره به برنامه، یک کلید جدید بسازید.
  • بخش جزئیات یک کلید میزان استفاده از آن را در ۳۰ روز گذشته نشان می‌دهد.
  • هر کلید محدودیت‌های خود را دارد. برنامه‌ای که بیش از حد مجاز درخواست بفرستد با کاهش سرعت مواجه می‌شود.
  • کلیدی که دسترسی متن پولی دارد به هرکسی که آن را داشته باشد اجازه می‌دهد داستان‌هایی را که خوانندگان برایش پول پرداخت می‌کنند بخواند. از آن مراقبت کنید.

مشکلات رایج

  • «به سقف تعداد کلیدهای مجاز رسیده‌اید. ابتدا کلیدی را که دیگر استفاده نمی‌کنید متوقف کنید.»
  • «یک نام برای کلید تعیین کنید.»
  • «حداقل یک کار مجاز برای کلید انتخاب کنید.»
  • «روزی در آینده را انتخاب کنید.»

پرسش‌ها

پرسش‌های متداول

آیا می‌توانم کلید را بعداً دوباره ببینم؟

خیر. به‌جای آن یک کلید جدید بسازید.

آیا چند برنامه می‌توانند از یک کلید استفاده کنند؟

می‌توانید این کار را بکنید، اما به هر برنامه کلید خودش را بدهید تا بتوانید فقط همان یکی را متوقف کنید.

مطالب مرتبط

بازخورد

آیا این مطلب مفید بود؟

همچنین موجود به زبان

هنوز به کمک نیاز دارید؟