5 דק'
זמן אינטגרציה ממוצע
### מבוא: הטמעת בדיקת נאותות באפליקציה שלכם
שילוב מנוע בדיקת נאותות עוצמתי באפליקציה שלכם יכול לשחרר ערך עצום, מאוטומציה של בדיקות רקע ועד תהליכי החלטה חכמים. מדריך זה מספק סקירה מקיפה של אינטגרציה עם ה-API של בודק דאטא, המיועד למפתחים שרוצים פתרון מהיר, אמין ומדרגי.
### שלב 1: קבלת מפתח API
1. **הרשמה:** אם עוד לא עשיתם זאת, [הירשמו לחשבון מפתח חינמי](/signup).
2. **מעבר ללוח הבקרה:** לאחר ההתחברות, עברו ל[לוח הבקרה](/dashboard) שלכם.
3. **יצירת מפתח:** בקטע "מפתחות API", צרו מפתח חדש ושמרו אותו במקום בטוח.
```
Authorization: Bearer YOUR_API_KEY
```
### שלב 2: קריאת ה-API הראשונה שלכם (דוגמת Python)
```python
import requests
import json
API_KEY = 'YOUR_API_KEY'
API_URL = 'https://api.bodekdata.com/v3/check'
FILE_PATH = 'path/to/your/registry-extract.pdf'
headers = {
'Authorization': f'Bearer {API_KEY}'
}
with open(FILE_PATH, 'rb') as f:
files = {
'file': (FILE_PATH, f, 'application/pdf')
}
data = {
'model': 'bodek-data-3.0',
'modules': json.dumps(['beneficial-ownership'])
}
response = requests.post(API_URL, headers=headers, files=files, data=data)
if response.status_code == 200:
result = response.json()
print("הבדיקה הושלמה בהצלחה!")
print("שם הישות:", result['report']['fields']['entityName'])
print("ציון סיכון:", result['report']['riskScore'])
else:
print(f"שגיאה: {response.status_code}")
print(response.json())
```
### שלב 3: טיפול בשפות ובסוגי בדיקות שונים (דוגמת Node.js)
```javascript
const axios = require('axios');
const fs = require('fs');
const FormData = require('form-data');
const API_KEY = 'YOUR_API_KEY';
const API_URL = 'https://api.bodekdata.com/v3/check';
const FILE_PATH = 'path/to/your/document.png';
const runCheck = async () => {
const form = new FormData();
form.append('file', fs.createReadStream(FILE_PATH));
form.append('languageHint', 'en+he');
form.append('checkType', 'identity');
try {
const response = await axios.post(API_URL, form, {
headers: {
...form.getHeaders(),
'Authorization': `Bearer ${API_KEY}`,
},
});
console.log('נתוני בדיקת זהות:', response.data.report.fields);
} catch (error) {
console.error('שגיאת API:', error.response ? error.response.data : error.message);
}
};
runCheck();
```
### שלב 4: עיבוד אסינכרוני ו-Webhooks לבדיקות מעמיקות
1. **שליחת הבקשה** ל-`/v3/check/async`. ה-API יחזיר מיד `jobId`.
2. **המתנה להתראה.** בסיום העיבוד, המערכת תשלח בקשת POST לכתובת webhook שתספקו.
3. **שליפת התוצאות** באמצעות ה-`jobId` מ-`/v3/results/{jobId}`.
```json
{
"jobId": "job-12345-abcde",
"status": "completed",
"timestamp": "2025-05-18T10:30:00Z"
}
```
### שיטות עבודה מומלצות וטיפול בשגיאות
- **אבטחת מפתח ה-API:** לעולם אל תחשפו את מפתח ה-API בקוד צד-לקוח.
- **טיפול במגבלות קצב:** אם תקבלו תשובת `429 Too Many Requests`, המתינו לפני ניסיון חוזר.
- **אימות קלטים:** ודאו שסוגי הקבצים והפרמטרים נתמכים כדי להימנע משגיאות `400 Bad Request`.
_מדריך זה מכסה את יסודות האינטגרציה. לתכונות מתקדמות נוספות, ראו את **[תיעוד ה-API המלא שלנו](/docs)**._
מוכנים לבנות עם ה-API שלנו?
שלבו בדיקת נאותות עוצמתית באפליקציה שלכם תוך דקות עם ה-SDK הידידותי למפתחים.
קבלו גישת API ←
Ready to automate your document processing? See how Bodek Data can save your team hours of manual work every week. Start a free trial or request a personalized demo.