# إعداد مهام معلومات تطبيق Apple

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/app_data/apple/app_info/task_post`

**Tags:** DataForSEO

يضع عملية بحث عن تطبيق واحد في App Store حسب `app_id` في قائمة الانتظار، ويعيد معرّف مهمة `id`. غير متزامن: يعيد الإرسال معرّف مهمة `id` في `tasks[0].id`، وتعيد أداة الجلب النتيجة فور جاهزيتها. استرجع النتيجة عبر `get_dataforseo_app_apple_app_info_fetch`. لا يوجد متغير HTML في جانب Apple.

### مرجع التسعير

- القياس: تكلفة الاستجابة المُبلَّغ عنها.
- تقدير الطلب المرجعي: 0.012 دولار أمريكي.
- مضاعف العميل المرجعي: 1.0. لا تُطبّقه مرة أخرى على مبلغ عميل مسوّى.

بيانات وصفية مرجعية فقط، وليست عرض سعر للحساب ولا سعرًا مضمونًا ولا حدًا للإنفاق. أرصدة الموارد ليست أرصدة Felo. تتبع الرسوم النهائية سجلات فوترة Felo.

## Related links

- [الأسعار](<https://dataforseo.com/pricing/api/app-store>)
- [مركز المساعدة](<https://dataforseo.com/help-center/pingbacks-postbacks-with-dataforseo-api>)

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **no**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": [
      "object",
      "null"
    ],
    "oneOf": [
      {
        "type": "object",
        "properties": {
          "app_id": {
            "type": "string",
            "description": "<em>معرّف التطبيق</em><br><strong>حقل مطلوب</strong><br>معرّف تطبيق الجوال على App Store؛<br>يمكنك العثور على المعرّف في عنوان URL لكل تطبيق مدرج في App Store؛<br>مثال:<br>في عنوان URL `https://apps.apple.com/us/app/id<strong>835599320</strong>`<br>المعرّف هو `835599320`"
          },
          "location_name": {
            "type": "string",
            "description": "<em>الاسم الكامل لموقع محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد <code>location_code</code></strong><br><strong>إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد <code>location_code</code></strong><br>يمكنك الحصول على قائمة المواقع المتاحة لمحرك البحث مع <code>location_name</code> عبر طلب منفصل إلى `https://api.dataforseo.com/v3/app_data/apple/locations`<br>مثال:<br><code class=\"long-string\">West Los Angeles,California,United States</code>"
          },
          "location_code": {
            "type": "integer",
            "description": "<em>رمز موقع محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد <code>location_name</code></strong><br><strong>إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد <code>location_name</code></strong><br>يمكنك الحصول على قائمة المواقع المتاحة لمحرك البحث مع <code>location_code</code> الخاصة بها عبر طلب منفصل إلى `https://api.dataforseo.com/v3/app_data/apple/locations`<br>مثال:<br><code class=\"long-string\">9061121</code>"
          },
          "language_name": {
            "type": "string",
            "description": "<em>الاسم الكامل للغة محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد <code>language_code</code></strong><br>إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد <code>language_code</code><br>يمكنك الحصول على قائمة اللغات المتاحة مع <code>language_name</code> عبر طلب منفصل إلى `https://api.dataforseo.com/v3/app_data/apple/languages`<br>مثال:<br><code class=\"long-string\">English</code>"
          },
          "language_code": {
            "type": "string",
            "description": "<em>رمز لغة محرك البحث</em><br><strong>حقل مطلوب إذا لم تحدد <code>language_name</code></strong><br>إذا استخدمت هذا الحقل، فلست بحاجة إلى تحديد <code>language_name</code><br>يمكنك الحصول على قائمة اللغات المتاحة مع <code>language_code</code> الخاصة بها عبر طلب منفصل إلى `https://api.dataforseo.com/v3/app_data/apple/languages`<em><br></em>مثال:<em><br></em><code class=\"long-string\">en</code>"
          },
          "priority": {
            "type": [
              "integer",
              "null"
            ],
            "description": "<em>أولوية المهمة</em><br>حقل اختياري<br>يمكن أن تأخذ القيم التالية:<br>1 – أولوية تنفيذ عادية (تُعيّن افتراضيًا)<br>2 – أولوية تنفيذ عالية. ستُحتسب عليك رسوم إضافية للمهام ذات أولوية التنفيذ العالية.<br>يمكن حساب التكلفة في صفحة الأسعار."
          },
          "tag": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>معرّف مهمة يحدده المستخدم</em><br>حقل اختياري<br><em>الحد الأقصى للأحرف هو 255</em><br>يمكنك استخدام هذا المعامل لتمييز المهمة ومطابقتها مع النتيجة<br>ستجد قيمة <code>tag</code> المحددة في كائن <code>data</code> ضمن الاستجابة"
          },
          "postback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>عنوان URL لإرسال نتائج المهمة</em><br>حقل اختياري<br>بمجرد اكتمال المهمة، سنرسل طلب POST بنتائجها مضغوطة بتنسيق <code>gzip</code> إلى <code>postback_url</code> الذي حددته<br>يمكنك استخدام السلسلة ‘$id’ كمتغير <code>$id</code> و‘$tag’ كمتغير <code>$tag</code> بترميز URL. سنعيّن القيم اللازمة قبل إرسال الطلب.<br>مثال:<br>`http://your-server.com/postbackscript?id=$id`<br>`http://your-server.com/postbackscript?id=$id&amp;tag=$tag`<br><strong>ملاحظة:</strong> ستُرمّز الأحرف الخاصة في <code>postback_url</code> بترميز URL؛ <br>أي أن الحرف <code>#</code> سيُرمّز إلى <code>%23</code><p>اطّلع على المزيد في مركز المساعدة"
          },
          "postback_data": {
            "type": "string",
            "description": "<em>نوع بيانات postback_url</em><br><strong>حقل مطلوب إذا حددت <code>postback_url</code></strong><br>يطابق نوع البيانات الذي سيُرسل إلى خادمك<br>القيم الممكنة:<br><code>advanced</code>"
          },
          "pingback_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "<em>عنوان URL للإشعار عند اكتمال المهمة</em><br>حقل اختياري<br>عند اكتمال المهمة سنشعرك عبر طلب GET يُرسل إلى عنوان URL الذي حددته<br>يمكنك استخدام السلسلة ‘$id’ كمتغير <code>$id</code> و‘$tag’ كمتغير <code>$tag</code> بترميز URL. سنعيّن القيم اللازمة قبل إرسال الطلب.<br>مثال:<br>`http://your-server.com/pingscript?id=$id`<br>`http://your-server.com/pingscript?id=$id&amp;tag=$tag`<br><strong>ملاحظة:</strong> ستُرمّز الأحرف الخاصة في <code>pingback_url</code> بترميز URL؛ <br>أي أن الحرف <code>#</code> سيُرمّز إلى <code>%23</code><p>اطّلع على المزيد في مركز المساعدة"
          }
        },
        "example": [
          {
            "app_id": "835599320",
            "location_code": 2840,
            "language_code": "en"
          }
        ]
      }
    ]
  },
  "example": [
    {
      "app_id": "835599320",
      "location_code": 2840,
      "language_code": "en"
    }
  ]
}
```

## Responses

### 200 — عملية ناجحة

Headers:
- `X-Request-Id` (string) — معرّف الطلب المراد تضمينه عند التواصل مع دعم Felo.

**application/json**

Schema: object | null

```json
{
  "type": [
    "object",
    "null"
  ],
  "oneOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_AppDataAppleAppInfoTaskPostResponseInfo"
    }
  ]
}
```

### 400 — تعذّرت معالجة الطلب. تحقق من معاملات الطلب.

### 401 — مطلوب مفتاح API صالح من Felo.

### 402 — لا يمكن متابعة الطلب لأن أحد متطلبات الفوترة غير مستوفٍ.

### 403 — الحساب غير مصرّح له بهذه العملية.

### 429 — تم بلوغ حد الطلبات أو حد الإنفاق.

### 502 — تعذّر على الخدمة إكمال الطلب.

### 503 — خدمة API أو الفوترة غير متاحة مؤقتًا.

### 504 — انتهت مهلة الخدمة أثناء معالجة الطلب.

### default — استجابة خطأ؛ قد تستخدم استجابات المنبع الممرَّرة تنسيقات المزوّد

**application/json**

Schema:

```json
{}
```

## Schema definitions

### Response36Afe1097B20_AppDataAppleAppInfoTaskPostResponseInfo

`#/components/schemas/Response36Afe1097B20_AppDataAppleAppInfoTaskPostResponseInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseInfo"
    },
    {
      "type": "object",
      "properties": {
        "tasks": {
          "type": [
            "array",
            "null"
          ],
          "items": {
            "type": [
              "object",
              "null"
            ],
            "oneOf": [
              {
                "$ref": "#/components/schemas/Response36Afe1097B20_AppDataAppleAppInfoTaskPostTaskInfo"
              }
            ]
          },
          "description": "<em>مصفوفة المهام</em>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_AppDataAppleAppInfoTaskPostTaskInfo

`#/components/schemas/Response36Afe1097B20_AppDataAppleAppInfoTaskPostTaskInfo`

```json
{
  "type": "object",
  "allOf": [
    {
      "$ref": "#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo"
    },
    {
      "type": "object",
      "properties": {
        "result": {
          "type": [
            "object",
            "null"
          ],
          "description": "<em>مصفوفة نتائج</em><br>في هذه الحالة، ستكون القيمة <code>null</code>"
        }
      }
    }
  ]
}
```

### Response36Afe1097B20_BaseResponseInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseInfo`

```json
{
  "properties": {
    "version": {
      "type": [
        "string",
        "null"
      ],
      "description": "الإصدار الحالي من API"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز الحالة العام\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "رسالة معلوماتية عامة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "إجمالي وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "tasks_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks",
      "format": "int64"
    },
    "tasks_error": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد المهام في مصفوفة tasks التي أُعيدت مع خطأ",
      "format": "int64"
    }
  }
}
```

### Response36Afe1097B20_BaseResponseTaskInfo

`#/components/schemas/Response36Afe1097B20_BaseResponseTaskInfo`

```json
{
  "properties": {
    "id": {
      "type": [
        "string",
        "null"
      ],
      "description": "معرّف المهمة\nمعرّف مهمة فريد في نظامنا بصيغة UUID"
    },
    "status_code": {
      "type": [
        "integer",
        "null"
      ],
      "description": "رمز حالة المهمة\nينشئه DataForSEO ويمكن أن يقع ضمن النطاق التالي: 10000-60000\nيمكنك العثور على القائمة الكاملة لرموز الاستجابة هنا"
    },
    "status_message": {
      "type": [
        "string",
        "null"
      ],
      "description": "الرسالة المعلوماتية للمهمة\nيمكنك العثور على القائمة الكاملة للرسائل المعلوماتية العامة هنا"
    },
    "time": {
      "type": [
        "string",
        "null"
      ],
      "description": "وقت التنفيذ، بالثواني"
    },
    "cost": {
      "type": [
        "number",
        "null"
      ],
      "description": "إجمالي تكلفة المهام، بالدولار الأمريكي",
      "format": "double"
    },
    "result_count": {
      "type": [
        "integer",
        "null"
      ],
      "description": "عدد العناصر في مصفوفة result",
      "format": "int64"
    },
    "path": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": [
          "string",
          "null"
        ]
      },
      "description": "مسار URL"
    },
    "data": {
      "type": [
        "object",
        "null"
      ],
      "additionalProperties": {
        "type": [
          "object",
          "null"
        ]
      },
      "description": "يحتوي على المعاملات نفسها التي حددتها في طلب POST"
    }
  }
}
```
