---
title: "کلید API"
description: "کلید API چیست، API حسابداری چطور با کلید Bearer کار می‌کند، دسترسی، چرخش و ابطال کلید در حسابدار من چگونه است و چطور کلید را امن نگه می‌داریم."
canonical: https://hesabdar.my/glossary/api-key
language: fa
publisher: "حسابدار من"
updated: 2026-11-06
---

# کلید API

> کلید API چیست، API حسابداری چطور با کلید Bearer کار می‌کند، دسترسی، چرخش و ابطال کلید در حسابدار من چگونه است و چطور کلید را امن نگه می‌داریم.

کلید API رشته رمز طولانی است که برنامه با هر درخواست به API می‌فرستد تا نشان دهد از طرف کدام حساب یا کسب‌وکار عمل می‌کند و چه کارهایی مجاز است. در نرم‌افزار حسابداری، کلید جای نام کاربری و رمز را برای اتصال‌هایی مثل فروشگاه اینترنتی، سیستم حقوق و دستمزد یا اسکریپت ثبت خودکار سند می‌گیرد.

کلید در سرآیند درخواست ارسال می‌شود، معمولاً به شکل `Authorization: Bearer <key>`. سرور آن را پیدا می‌کند، فعال بودن و دسترسی لازم را بررسی می‌کند و درخواست را در چارچوب کسب‌وکاری که کلید به آن تعلق دارد اجرا می‌کند.

در [حسابدار من](https://hesabdar.my/developers) هر کلید به یک کسب‌وکار تعلق دارد و مالک آن را مدیریت می‌کند: دسترسی خواندن یا نوشتن دارد، هنگام رفتن یک همکار یا احتمال افشا قابل چرخش است و فوراً باطل می‌شود. هر فراخوانی با کلید مربوط در ردپای حسابرسی ثبت می‌شود تا معلوم باشد کدام اتصال کدام سند را ثبت کرده است.

با کلید مثل رمز عبور رفتار کنید: در متغیر محیطی یا مخزن امن نگه دارید، هرگز در کد سمت مرورگر یا مخزن عمومی نگذارید، برای هر اتصال کلید جداگانه با کمترین دسترسی لازم بسازید و کلیدها را دوره‌ای بچرخانید. [راهنمای API حسابداری](https://hesabdar.my/guides/accounting-api) یک اتصال کامل را نشان می‌دهد.

## مثال: ثبت سند با کلید API

فروشگاه اینترنتی پس از هر سفارش پرداخت‌شده سند فروش می‌سازد. سرور فروشگاه درخواست `POST /api/v1/journal-entries` را با سرآیند `Authorization: Bearer <کلید فروشگاه>` و `Idempotency-Key: shop-order-1045` می‌فرستد. اگر کلید باطل شده باشد، پاسخ ۴۰۱ برمی‌گردد و سندی ساخته نمی‌شود.

### فرق کلید API با توکن OAuth چیست؟

کلید API رمز ثابتی است که برای یک اتصال صادر می‌شود و تا ابطال معتبر است. توکن OAuth پس از اجازه کاربر صادر می‌شود و معمولاً زود منقضی می‌شود. کلید برای اتصال سرور به سروری که خودتان کنترل می‌کنید مناسب است.

### اگر کلید API افشا شد چه کنیم؟

فوراً آن را باطل کنید یا بچرخانید، کلید جدید را در اتصال جایگزین کنید و ردپای حسابرسی را برای فراخوانی‌های کلید قبلی بررسی کنید.

راهنما: https://hesabdar.my/guides/accounting-api