Что такое код udm_api_version

Содержание

�������� ������ mnoGoSearch API

(PHP 4 >= 4.0.5, PHP 5 = 1.0.0)

udm_api_version � �������� ������ mnoGoSearch API

��������

�������� ������ mnoGoSearch API.

��� ������� ��������� ������������ ������, ����� ������� API ��������, ��������, ������� udm_get_doc_count() �������� ������ � mnoGoSearch 3.1.11 ��� ����.

������������ ��������

udm_api_version() ���������� ����� ������ mnoGoSearch API. ��������, ���� ������������ mnoGoSearch 3.1.10 API, ��� ������� ������ 30110.

�������

������ #1 ������ ������������� udm_api_version()

udm_api_version

(PHP 4 >= 4.0.5, PHP 5 = 1.0.0)

udm_api_version � �������� ������ mnoGoSearch API

��������

�������� ������ mnoGoSearch API.

��� ������� ��������� ������������ ������, ����� ������� API ��������, ��������, ������� udm_get_doc_count() �������� ������ � mnoGoSearch 3.1.11 ��� ����.

������������ ��������

udm_api_version() ���������� ����� ������ mnoGoSearch API. ��������, ���� ������������ mnoGoSearch 3.1.10 API, ��� ������� ������ 30110.

�������

������ #1 ������ ������������� udm_api_version()

����� �������� �� ������� API Android Understanding Android API levels

Xamarin. Android ����� ��������� ���������� ������ API Android, ������� ���������� ������������� ���������� � ����������� �������� Android. � ���� ����������� �����������, ��� �������� ��� ���������, ��� �� ��������� � ��� ��� ������ �� ���������� �� ����� ����������. Xamarin.Android has several Android API level settings that determine your app’s compatibility with multiple versions of Android. This guide explains what these settings mean, how to configure them, and what effect they have on your app at run time.

������� ������ ������ Quick start

Xamarin. Android ������������� ��� ��������� ������� ������ API Android: Xamarin.Android exposes three Android API level project settings:

������� ��������� � ���������, ����� ��������� ����� �������������� ��� ������ ����������. Target Framework � Specifies which framework to use in building your application. ���� ������� API ������������ �� ����� ���������� Xamarin. Android. This API level is used at compile time by Xamarin.Android.

����������� ������ android � ��������� ����� ������ ������ Android, ������� ������ ������������ ���� ����������. Minimum Android Version � Specifies the oldest Android version that you want your app to support. ���� ������� API ������������ Android �� ����� ���������� . This API level is used at run time by Android.

������� ������ android � ��������� ������ Android, �� ������� ������ ����������� ����������. Target Android Version � Specifies the version of Android that your app is intended to run on. ���� ������� API ������������ Android �� ����� ���������� . This API level is used at run time by Android.

������ ��� ����� ����� ��������� ������� API ��� �������, ���������� ���������� ���������� ��������� SDK ��� ����� ������ API. Before you can configure an API level for your project, you must install the SDK platform components for that API level. �������������� �������� � �������� � ��������� ����������� ����� SDK ��� Android ��. � ������� ����� SDK ��� Android Setup. For more information about downloading and installing Android SDK components, see Android SDK Setup.

������� � ������� 2020, ������� Google Play ���������, ����� ����� ���������� ���� �������� �� ������� API 26 (Android 8,0) ��� ����� ������� ������. Beginning in August 2020, the Google Play Console will require that new apps target API level 26 (Android 8.0) or higher. ������������ ���������� ������ ���� �������� �� ������� API 26 ��� ����, ������� � ������ 2020. Existing apps will be required to target API level 26 or higher beginning in November 2020. �������������� �������� ��. � ������ ��������� ������������ � ������������������ ���������� �� Google Play � ������� ����. For more information, see Improving app security and performance on Google Play for years to come.

��� �������, ��� ���� ���� ������� API Xamarin. Android ������ ���� � �� �� ��������. Normally, all three Xamarin.Android API levels are set to the same value. �� �������� ���������� ������� ��� ��������� ������������� � ������� ������ Android (������� ���������) ��������� ���������� ������ API (���, ��� �������, �� ������ Android, ������� �������� ��� ����������� ����������). On the Application page, set Compile using Android version (Target Framework) to the latest stable API version (or, at a minimum, to the Android version that has all of the features you need). �� ��������� ������ ������ ��� ������� ��������� ������ �������� Android 7,1 (API ������ 25-Nougat) : In the following screenshot, the Target Framework is set to Android 7.1 (API Level 25 — Nougat):

�� �������� ��������� Android ���������� ����������� ������ Android ��� ������������� ���������� � �������������� ������ ������ SDK � ������� ��� ������� ������ Android �� �� ��������, ��� � ��� ������� ������ .NET Framework (�� ��������� ������ ������ ������� ��������� Android ����� �������� Android 7,1 (Nougat) ): On the Android Manifest page, set the Minimum Android version to Use Compile using SDK version and set the Target Android version to the same value as the Target Framework version (in the following screenshot, the Target Android Framework is set to Android 7.1 (Nougat)):

���� �� ������ ���������� �������� ������������� � ����� ������ ������� Android, ������� ��� ����������� ������ Android ������� ������ Android, ������� ����� �������������� ����� �����������. If you want to maintain backward compatibility with an earlier version of Android, set Minimum Android version to target to the oldest version of Android that you want your app to support. (�������� ��������, ��� ������� API 14 � ��� ����������� ������� API, ����������� ��� Google Play ����� � ��������� Firebase.) � ��������� ������� ������������ ������������ ������ Android �� API ������ 14 ����� ������� API 25. (Note that API Level 14 is the minimum API level required for Google Play services and Firebase support.) The following example configuration supports Android versions from API Level 14 through API level 25:

��� �������, ��� ���� ���� ������� API Xamarin. Android ������ ���� � �� �� ��������. Normally, all three Xamarin.Android API levels are set to the same value. ������� ��� ������� ��������� ��������� ���������� ������ API (���, ��� �������, �� ������ Android, ������� �������� ��� ����������� ����������). Set Target framework to the latest stable API version (or, at a minimum, to the Android version that has all of the features you need). ����� ������ ������� ���������, ��������� � ������� ������ > ��������������� �������. To set the Target framework, navigate to Build > General in the Project Options. �� ��������� ������ ������ ������� ��������� ��������� ��� ������������� ��������� ������������� ��������� (8,0) : In the following screenshot, the Target Framework is set to Use the latest installed platform (8.0):

��������� ����������� � ������� ������ Android ����� ����� � ������� ������ > ���������� Android���������� �������. The Minimum and Target Android version settings can be found under Build > Android Application in Project Options. ������� ����������� ������ Android ��� ��������������� ������������� ������� ������ .NET Framework � ������� � �������� ������� ������ Android �� �� ��������, ��� � � ������� ������ .NET Framework. Set the Minimum Android version to Automatic — use target framework version and set the Target Android version to the same value as the Target Framework version. �� ��������� ������ ������ ������� ��������� Android ��������� �� android 8,0 (API ������ 26) � ������������ � ���������� ������� ��������� ����: In the following screenshot, the Target Android Framework is set to Android 8.0 (API level 26) to match the Target Framework setting above:

���� �� ������ ���������� �������� ������������� � ����� ������ ������� Android, �������� ����������� ������ Android �� ����� ������ ������ Android, ������� ������ ������������ ���� ����������. If you want to maintain backward compatibility with an earlier version of Android, change Minimum Android version to the oldest version of Android that you want your app to support. �������� ��������, ��� ������� API 14 � ��� ����������� ������� API, ����������� ��� Google Play ����� � ��������� Firebase. Note that API Level 14 is the minimum API level required for Google Play services and Firebase support. ��������, ��������� ������������ ������������ ������ Android ��� ������, ��� API ������ 14: For example, the following configuration supports Android versions as early as API Level 14:

���� ���������� ������������ ��������� ������ Android, � ���� ������ ����������� �������� ����� ����������, ����� ���������� ������ ���������� � ����������� ������� Android (�������������� �������� ��. � ������� �������� ����� ���������� ��� ������ Android ����). If your app supports multiple Android versions, your code must include runtime checks to ensure that your app works with the Minimum Android version setting (see Runtime Checks for Android Versions below for details). ���� �� ����������� ��� �������� ����������, ������������ �� ������� ������ API � ���������� ����, ����� �������� ������������ �� ��������� ���������� ������ API ��� ���������. If you are consuming or creating a library, see API Levels and Libraries below for best practices in configuring API level settings for libraries.

������ Android � ������ API Android versions and API levels

�� ���� �������� ��������� Android � ������� ����� ������ Android ������ ������ Android ����������� ���������� ������������� �������������, ���������� ������� API. As the Android platform evolves and new Android versions are released, each Android version is assigned a unique integer identifier, called the API Level. ����� �������, ������ ������ Android ������������� ������ ������ API Android. Therefore, each Android version corresponds to a single Android API Level. ��� ��� ������������ ������������� ���������� �� ����� ������ ������, � ����� � ����� ��������� ������� Android, ���������� ��� ������ � �������� ������� ��� Android ������ ���� ����������� � ����������� �������� API Android. Because users install apps on older as well as the most recent versions of Android, real-world Android apps must be designed to work with multiple Android API levels.

������ Android Android versions

������ ������ Android �������� ��������� ����: Each release of Android goes by multiple names:

  • ������ Android, �������� android 9,0 The Android version, such as Android 9.0
  • ��� ���� (��� ������), �������� �������� ��������� A code (or dessert) name, such as Pie
  • ��������������� ������� API, �������� ������� API 28 A corresponding API level, such as API level 28

��� ���� Android ����� ��������������� ���������� ������� � ������� API (��� �������� � ������� ����), �� ������ ������ Android ������������� ����� ������ ������ API. An Android code name may correspond to multiple versions and API levels (as seen in the table below), but each Android version corresponds to exactly one API level.

����� ����, Xamarin. Android ���������� ���� ������ ������ , ������� �������������� � ���������� �������� API Android. In addition, Xamarin.Android defines build version codes that map to the currently known Android API levels. ��������� ������� ������� ��� ��������� �������������� ����� ������� API, ������� Android, ������� ������ � ����� ������ ������ Xamarin. Android (���� ������ ������ ������������ � ������������ ���� Android.OS ): The following table can help you translate between API level, Android version, code name, and Xamarin.Android build version code (build version codes are defined in the Android.OS namespace):

name Name Version Version ������� API API Level �������� Released ��� ������ ������ Build Version Code
�������� ��������� Pie 9.0 9.0 28 28 ��� 2020 Aug 2020 BuildVersionCodes.P
Oreo Oreo 8.1 8.1 27 27 Dec 2020 Dec 2020 BuildVersionCodes.OMr1
Oreo Oreo 8.0 8.0 26 26 ��� 2020 Aug 2020 BuildVersionCodes.O
Nougat Nougat 7.1 7.1 25 25 Dec 2020 Dec 2020 BuildVersionCodes.NMr1
Nougat Nougat 7.0 7.0 24 24 ��� 2020 Aug 2020 BuildVersionCodes.N
Marshmallow Marshmallow 6.0 6.0 23 23 ��� 2015 Aug 2015 BuildVersionCodes.M
���������� Lollipop 5.1 5.1 22 22 ��� 2015 Mar 2015 BuildVersionCodes.LollipopMr1
���������� Lollipop 5.0 5.0 21 21 2014 ������ Nov 2014 BuildVersionCodes.Lollipop
KitKat Watch Kitkat Watch 4.4 W 4.4W 20 20 ���� 2014 Jun 2014 BuildVersionCodes.KitKatWatch
KitKat Kitkat 4,4 4.4 19 19 ������� 2013 Oct 2013 BuildVersionCodes.KitKat
Jelly Bean Jelly Bean 4.3 4.3 18 18 ��� 2013 Jul 2013 BuildVersionCodes.JellyBeanMr2
Jelly Bean Jelly Bean 4.2 � 4.2.2 4.2-4.2.2 17 17 2012 ������ Nov 2012 BuildVersionCodes.JellyBeanMr1
Jelly Bean Jelly Bean 4.1 � 4.1.1 4.1-4.1.1 16 16 ���� 2012 Jun 2012 BuildVersionCodes.JellyBean
����� ���������� Ice Cream Sandwich 4.0.3 � 4.0.4 4.0.3-4.0.4 15 15 Dec 2011 Dec 2011 BuildVersionCodes.IceCreamSandwichMr1
����� ���������� Ice Cream Sandwich 4.0 � 4.0.2 4.0-4.0.2 14 14 ������� 2011 Oct 2011 BuildVersionCodes.IceCreamSandwich
��������� Honeycomb 3,2 3.2 13 13 ���� 2011 Jun 2011 BuildVersionCodes.HoneyCombMr2
��������� Honeycomb 3.1. x 3.1.x 12 12 ��� 2011 May 2011 BuildVersionCodes.HoneyCombMr1
��������� Honeycomb 3.0. x 3.0.x 11 11 ��� 2011 Feb 2011 BuildVersionCodes.HoneyComb
Gingerbread Gingerbread 2.3.3 � 2.3.4 2.3.3-2.3.4 10 10 ��� 2011 Feb 2011 BuildVersionCodes.GingerBreadMr1
Gingerbread Gingerbread 2.3 � 2.3.2 2.3-2.3.2 9 9 2010 ������ Nov 2010 BuildVersionCodes.GingerBread
����� Froyo 2.2. x 2.2.x 8 8 ���� 2010 Jun 2010 BuildVersionCodes.Froyo
������ Eclair 2.1. x 2.1.x 7 7 ��� 2010 Jan 2010 BuildVersionCodes.EclairMr1
������ Eclair 2.0.1 2.0.1 6 6 Dec 2009 Dec 2009 BuildVersionCodes.Eclair01
������ Eclair 2.0 2.0 5 5 2009 ������ Nov 2009 BuildVersionCodes.Eclair
������ Donut 1.6 1.6 4 4 Sep 2009 Sep 2009 BuildVersionCodes.Donut
������� Cupcake 1.5 1.5 3 3 ��� 2009 May 2009 BuildVersionCodes.Cupcake
������� Base 1.1 1.1 2 2 ��� 2009 Feb 2009 BuildVersionCodes.Base11
������� Base 1.0 1.0 1 1 ������� 2008 Oct 2008 BuildVersionCodes.Base

��� �������� � ���� �������, ����� ������ Android ����� ����������� � ������ ����� ��� �� ���� ������ � ���. As this table indicates, new Android versions are released frequently � sometimes more than one release per year. � ���������� ����� ��������� Android, �� ������� ����� �������� ���� ����������, �������� � ���� ��������� ����� ������ � ����� ����� ������ Android. As a result, the universe of Android devices that might run your app includes of a wide variety of older and newer Android versions. ��� �� ������ �������������, ��� ���������� ����� ����������� ������������ � ������� �� ������ ������� Android? How can you guarantee that your app will run consistently and reliably on so many different versions of Android? ������ API ��� Android ����� ������ � ���������� ���� ���������. Android’s API levels can help you manage this problem.

������ API Android Android API levels

������ ���������� Android ����������� �� ������ API, � ���� ������� API �������������� �������� ��� ������ ������ ��������� Android. Each Android device runs at exactly one API level � this API level is guaranteed to be unique per Android platform version. ������� API ����� ���������� ������ ������ API, � �������� ����� ���������� ����������. �� ���������� ��������� ��������� ���������, ���������� � �. �., ������� �� ������� � �������� ������������. The API level precisely identifies the version of the API set that your app can call into; it identifies the combination of manifest elements, permissions, etc. that you code against as a developer. ������� Android �� ������� API ��������� Android ����������, ���������� �� ���������� � ������� ������� Android ����� ���������� ���������� �� ����������. Android’s system of API levels helps Android determine whether an application is compatible with an Android system image prior to installing the application on a device.

��� ������ ���������� �� �������� ��������� �������� �� ������ API: When an application is built, it contains the following API level information:

������� ������� API Android, �� ������� ��������� ���������� ��� �������. The target API level of Android that the app is built to run on.

����������� ������� API Android, ������� ������ ����� ���������� Android ��� ������� ����������. The minimum Android API level that an Android device must have to run your app.

��� ��������� ������������, ����� ���������, ��� �������, ����������� ��� ����������� ������� ����������, �������� �� ���������� Android �� ����� ���������. These settings are used to ensure that the functionality needed to run the app correctly is available on the Android device at installation time. � ��������� ������ ���������� ����������� �� ���� ����������. If not, the app is blocked from running on that device. ��������, ���� ������� API ���������� Android ���� ������������ ������ API, ���������� ��� ����������, ���������� Android �� �������� ������������ ���������� ����������. For example, if the API level of an Android device is lower than the minimum API level that you specify for your app, the Android device will prevent the user from installing your app.

��������� ������ API ������� Project API level settings

� ��������� �������� �����������, ��� � ������� ���������� ������� SDK ����������� ����� ���������� ��� ������� API, ������� �� ������ �������������, � ����� �������� ���������, ��� ��������� ������� ���������, ����������� ������ Android��������� ������� ������ Android � Xamarin. Android. The following sections explain how to use the SDK Manager to prepare your development environment for the API levels you want to target, followed by detailed explanations of how to configure Target Framework, Minimum Android version, and Target Android version settings in Xamarin.Android.

��������� ����� SDK ��� Android Android SDK platforms

������ ��� ����� ����� ������� ������� ��� ����������� ������� API � Xamarin. Android, ���������� ���������� ����� SDK ��� Android ������ ���������, ��������������� ����� ������ API. Before you can select a Target or Minimum API level in Xamarin.Android, you must install the Android SDK platform version that corresponds to that API level. �������� ��������� ��������� ��� ������� ���������, ����������� ������ Android � ������� ������ Android ��������� ���������� ������������� ������ ����� SDK ��� Android. The range of available choices for Target Framework, Minimum Android version, and Target Android version is limited to the range of Android SDK versions that you have installed. � ������� ���������� ������� SDK ����� ���������, ����������� �� ��������� ������ ����� SDK ��� Android, � ����� ������������ �� ��� ���������� ����� ������� API, ����������� ��� ����������. You can use the SDK Manager to verify that the required Android SDK versions are installed, and you can use it to add any new API levels that you need for your app. ���� �� �� ������� � ���������� ������� API, ��. ������ ����� SDK ��� Android Setup. If you are not familiar with how to install API levels, see Android SDK Setup.

��������� ������ .NET Framework Target Framework

������� ��������� (����� ��������� ��� compileSdkVersion ) � ��� ���������� ������ ��������� Android (������� API), ��� ������� ������������� ���������� �� ����� ������. The Target Framework (also known as compileSdkVersion ) is the specific Android framework version (API level) that your app is compiled for at build time. ���� �������� ���������, ����� API- ���������� ����� ������������ ���������� ��� ��� �������, �� �� ������ �� ��, ����� API ���������� �������� ��� ���������� ��� ��� ���������. This setting specifies what APIs your app expects to use when it runs, but it has no effect on which APIs are actually available to your app when it is installed. � ���������� ��������� ��������� ������� ��������� �� �������� � ��������� ��������� ����� ����������. As a result, changing the Target Framework setting does not change runtime behavior.

������� ��������� ���������� ������ ���������, � �������� ������� ����������, � ���� �������� ����������, ����� ���������� API ����� ������������ � ����������. The Target Framework identifies which library versions your application is linked against � this setting determines which APIs you can use in your app. ��������, ���� �� ������ ������������ ����� �������������������. ����������� , ������� �������� � ���������� ���������������� Android 5,0, ���������� ������ ������� ��������� �� ������ API 21 (��� �������� ��������) ��� ����� ������� ������. For example, if you want to use the NotificationBuilder.SetCategory method that was introduced in Android 5.0 Lollipop, you must set the Target Framework to API Level 21 (Lollipop) or later. ���� ������ ������� ��������� ������� �� ������ API, �������� �� ������ API 19 (KitKat) , � ���������� ������� ����� SetCategory � ����, ��������� ������ ����������. If you set your project’s Target Framework to an API level such as API Level 19 (KitKat) and try to call the SetCategory method in your code, you will get a compile error.

������������� ������ ��������������� � ��������� ��������� ������� ������� ���������. We recommend that you always compile with the latest available Target Framework version. ��� ��������� �������� �������� �������������� ��� ���� ���������� ����������� API, ������� ����� ���� ������� �����. Doing so provides you with helpful warning messages for any deprecated APIs that might be called by your code. ������������� ��������� ������ ������� ��������� �������� ����� ��� ������������� ��������� �������� ���������� ��������� � ������ ���������� ������������, ��� ���������� ������ ���� �������������� �� ������ ������������ ������ API ���������� ��������� ��� ����. Using the latest Target Framework version is especially important when you use the latest support library releases � each library expects your app to be compiled at that support library’s minimum API level or greater.

����� �������� ������ � ��������� ������� ��������� � Visual Studio, �������� �������� ������� � ������������ ������� � �������� �������� ���������� : To access the Target Framework setting in Visual Studio, open the project properties in Solution Explorer and select the Application page:

������� ������� ���������, ������ ������� API � �������������� ���� � ������� ������������� � �������������� ������ Android , ��� �������� ����. Set the Target Framework by selecting an API level in the drop-down menu under Compile using Android version as shown above.

����� �������� ������ � ��������� ������� ��������� � Visual Studio ��� Mac, �������� ������ ������� ���� ��� ������� � �������� ����� ���������. ��������� ���������� ���� ��������� ������� . To access the Target Framework setting in Visual Studio for Mac, right-click the project name and select Options; this opens the Project Options dialog. � ���� ���������� ���� ��������� � ������ Build > General (����� ), ��� �������� ����: In this dialog, navigate to Build > General as shown here:

������� ������� ���������, ������ ������� API � �������������� ���� ������ �� ������� ��������� , ��� �������� ����. Set the Target Framework by selecting an API level in the drop-down menu to the right of Target framework as shown above.

����������� ������ Android Minimum Android Version

����������� ������ Android (����� ��������� ��� minSdkVersion ) � ��� ����� ������ ������ �� Android (�� ���� ����� ������ ������� API), ������� ����� ���������� � ��������� ����������. The Minimum Android version (also known as minSdkVersion ) is the oldest version of the Android OS (i.e., the lowest API level) that can install and run your application. �� ��������� ���������� ����� ���� ����������� ������ �� �����������, ��������������� ��������� ������� ��������� ��� ����. ���� ����������� ������ Android ������, ��� ������� ���������, ���������� ����� ����� �������� � ����� ������ ������� Android. By default, an app can only be installed on devices matching the Target Framework setting or higher; if the Minimum Android version setting is lower than the Target Framework setting, your app can also run on earlier versions of Android. ��������, ���� ������ � �������� ������� ��������� android 7,1 (Nougat) � ���������� ��� ����������� ������ Android �������� Android 4.0.3 (Ice-����� ����������) , ���������� ����� ���������� �� ����� ��������� � ������ API 15 �� ������� API 25 ������������. For example, if you set the Target Framework to Android 7.1 (Nougat) and set the Minimum Android version to Android 4.0.3 (Ice Cream Sandwich), your app can be installed on any platform from API level 15 to API level 25, inclusive.

�������� �� ��, ��� ���������� ����� ������� ����������� � ��������������� �� ���� ��������� ��������, ��� �� �����������, ��� �� ����� ������� ������� �� ���� ���� ����������. Although your app may successfully build and install on this range of platforms, this does not guarantee that it will successfully run on all of these platforms. ��������, ���� ���������� ����������� � android 5,0 (��� �������� ��������) � ��� �������� API, ��������� ������ � Android 7,1 (Nougat) � ����� ������� ������, ���������� ������� ������ �� ����� ���������� �, ��������, �������� � ����. For example, if your app is installed on Android 5.0 (Lollipop) and your code calls an API that is available only in Android 7.1 (Nougat) and newer, your app will get a runtime error and possibly crash. ������� ��� ������ ���������� � �� ����� ���������� �, ��� �� �������� ������ �� ���������� API, ������� �������������� ����������� Android, �� ������� ��� �����������. Therefore, your code must ensure � at runtime � that it calls only those APIs that are supported by the Android device that it is running on. ����� �������, ��� ������ �������� ����� �������� ����� ����������, ����� �������������, ��� ���������� ���������� ����� ����� API ������ �� ��� �����������, ������� ���������� ��������� ��� �� ���������. In other words, your code must include explicit runtime checks to ensure that your app uses newer APIs only on devices that are recent enough to support them. �������� ����� ���������� ��� ������ Android����� � ���� ����������� ���������, ��� �������� ��� �������� ����� ���������� � ���. Runtime Checks for Android Versions, later in this guide, explains how to add these runtime checks to your code.

����� �������� ������ � ��������� ����������� ������ Android � Visual Studio, �������� �������� ������� � ������������ ������� � �������� �������� ��������� Android . To access the Minimum Android version setting in Visual Studio, open the project properties in Solution Explorer and select the Android Manifest page. � �������������� ���� � ������� ����������� ������ Android ����� ������� ����������� ������ Android ��� ����������: In the drop-down menu under Minimum Android version you can select the Minimum Android version for your application:

���� ������� �������� ������������ ���������� � �������������� ������ ������ SDK, ����������� ������ Android ����� ��������� � ������� ����������. If you select Use Compile using SDK version, the Minimum Android version will be the same as the Target Framework setting.

����� �������� ������ � ����������� ������ Android � Visual Studio ��� Mac, �������� ������ ������� ���� ��� ������� � �������� ����� ���������. ��������� ���������� ���� ��������� ������� . To access the Minimum Android version in Visual Studio for Mac, right-click the project name and select Options; this opens the Project Options dialog. ��������� � ������ > ���������� Android. Navigate to Build > Android Application. � ������� ��������������� ���� ������ �� ����������� ������ Android����� ������ ����������� ������ Android ��� ����������: Using the drop-down menu to the right of Minimum Android version, you can set the Minimum Android version for your application:

��� ������ ��������� ������������� � ������������ ������� ������ .NET Framework����������� ������ Android ����� ��������� � ������� ����������. If you select Automatic � use target framework version, the Minimum Android version will be the same as the Target Framework setting.

������� ������ Android Target Android Version

������� ������ Android (����� ��������� ��� targetSdkVersion ) � ��� ������� API ���������� Android, �� ������� ������ ����������� ����������. The Target Android Version (also known as targetSdkVersion ) is the API level of the Android device where the app expects to run. Android ���������� ���� ��������, ����� ����������, ������� �� �������� ����� ��������� ������������� � ��� �����������, ��� ���������� ��������� �������� ���, ��� �� ����������. Android uses this setting to determine whether to enable any compatibility behaviors � this ensures that your app continues to work the way you expect. Android ���������� �������� ������� ������ Android ����������, ����� ����������, ����� ��������� ��������� ����� ��������� � ���������� ��� ��� ��������� (��� ��, ��� Android ������������ ������ �������������). Android uses the Target Android version setting of your app to figure out which behavior changes can be applied to your app without breaking it (this is how Android provides forward compatibility).

������� ��������� � ������� ������ Android � ����� �������� ������� �� ���������. The Target Framework and the Target Android version, while having very similar names, are not the same thing. �������� ������� ��������� �������� �������� � ������� ������ API � Xamarin. Android ��� ������������� �� ����� ����������, � ������� ������ Android �������� �������� � ������� ���������� API � Android ��� ������������� �� ����� ���������� (���� ���������� ���������� � �������� �� ����������). The Target Framework setting communicates target API level information to Xamarin.Android for use at compile time, while the Target Android version communicates target API level information to Android for use at run time (when the app is installed and running on a device).

����� �������� ������ � ����� ��������� � Visual Studio, �������� �������� ������� � ������������ ������� � �������� �������� ��������� Android . To access this setting in Visual Studio, open the project properties in Solution Explorer and select the Android Manifest page. � �������������� ���� � ������� ������� ������ Android ����� ������� ������� ������ Android ��� ����������: In the drop-down menu under Target Android version you can select the Target Android version for your application:

������������� ���� ������� � �������� ������� ������ Android ��������� ������ Android, ������������ ��� ������������ ����������. We recommend that you explicitly set the Target Android version to the latest version of Android that you use to test your app. � ������ ��� ���� ������� ���������� ��������� ������ ����� SDK ��� Android � ��� ��������� ������������ ����� ���������� API �� ������ ������ � ����������� ���������. Ideally, it should be set to the latest Android SDK version � this allows you to use new APIs prior to working through the behavior changes. ��� ����������� ������������� �� ������������� �������� � �������� ������� ������ Android ������������� ������� Compile � �������������� ������ ������ SDK. For most developers, we do not recommend setting the Target Android version to Use Compile using SDK version.

����� �������� ������ � ����� ��������� � Visual Studio ��� Mac, �������� ������ ������� ���� ��� ������� � �������� ����� ���������. ��������� ���������� ���� ��������� ������� . To access this setting in Visual Studio for Mac, right-click the project name and select Options; this opens the Project Options dialog. ��������� � ������ > ���������� Android. Navigate to Build > Android Application. � ������� ��������������� ���� ������ �� ������� ������ Android����� ������ ������� ������ Android ��� ����������: Using the drop-down menu to the right of Target Android version, you can set the Target Android version for your application:

������������� ���� ������� � �������� ������� ������ Android ��������� ������ Android, ������������ ��� ������������ ����������. We recommend that you explicitly set the Target Android version to the latest version of Android that you use to test your app. � ������ ������� ���������� ��������� ��������� ������ ����� SDK ��� Android � ��� ��������� ������������ ����� ���������� API �� ������ ������ � ����������� ���������. Ideally, it should be set to the latest available Android SDK version � this allows you to use new APIs prior to working through the behavior changes. ��� ����������� ������������� �� ������������� ������������� ������� ������ Android ��� ��������������� ������������� ������� ������ .NET Framework. For most developers, we do not recommend setting the Target Android version to Automatic — use target framework version.

� ����� ������ ������� ������ Android ������ ���� ���������� ����������� ������� Android � ������� ����������. In general, the Target Android Version should be bounded by the Minimum Android Version and the Target Framework. ��� �������� ���������: That is:

����������� ������ Andro > Minimum Andro >

�������������� �������� �� ������� ������ SDK ��. � ������������ ������������ Android � ������� ������ SDK . For more information about SDK levels, see the Android Developer uses-sdk documentation.

�������� ����� ���������� ��� ������ Android Runtime checks for Android versions

����� ������� ������ ����� ������ Android API ��������� ����������� ��� �������������� ����� ��� ���������� �������. As each new version of Android is released, the framework API is updated to provide new or replacement functionality. �� ���������� ������������, �������������� ����������� API �� ���������� ������ Android ����������� � ����� ����� ������ Android ��� ���������. With few exceptions, API functionality from earlier Android versions is carried forward into newer Android versions without modifications. � ����������, ���� ���������� �������� �� ������������ ������ API Android, ���, ��� �������, ����� �������� �� ����� ������� ������ API Android ��� ���������. As a result, if your app runs on a particular Android API level, it will typically be able to run on a later Android API level without modifications. �� ��� ������, ���� �� ����� ������ ��������� ���������� � ����� ������ ������� Android? But what if you also want to run your app on earlier versions of Android?

��� ������ ����������� ������ Android, ������� ���� ������� ���������, ��������� API ����� ���� ���������� ���������� �� ����� ����������. If you select a Minimum Android version that is lower than your Target Framework setting, some APIs may not be available to your app at runtime. ������ ���������� ��-�������� ����� �������� �� ����� ������ ����������, �� � ������������ �����������������. However, your app can still run on an earlier device, but with reduced functionality. ��� ������� API, ������� ���������� �� ���������� Android, ��������������� ��������� ����������� ������ Android, ��� ������ ���� ��������� �������� �������� Android.OS.Build.VERSION.SdkInt , ����� ���������� ������� API ���������, �� ������� �������� ����������. For each API that is not available on Android platforms corresponding to your Minimum Android version setting, your code must explicitly check the value of the Android.OS.Build.VERSION.SdkInt property to determine the API level of the platform the app is running on. ���� ������� API ������, ��� ����������� ������ Android, �������������� API, ������� ����� �������, �� ��� ������ ����� ������ ���������� ������ ��� ���������� ����� ������ API. If the API level is lower than the Minimum Android version that supports the API you want to call, then your code has to find a way to function properly without making this API call.

��������, �����������, ��� �� ����� ������������ ����� �������������������. ����������� ��� ������������� ����������� ��� ������ � ����������� ������������ ������� Android 5,0 (� ����� ������� �������), �� �� ��-�������� �����, ����� ���� ���������� ����������� � ����� ������ ������� Android, �������� Android 4,1 Jelly Bean (��� SetCategory ����������). For example, let’s suppose that we want to use the NotificationBuilder.SetCategory method to categorize a notification when running on Android 5.0 Lollipop (and later), but we still want our app to run on earlier versions of Android such as Android 4.1 Jelly Bean (where SetCategory is not available). ������ �� ������� ������ Android � ������ ����� ������������, �� �����, ��� ��� ������ ������ ��� Android 5,0 ��� �������� �������� Android.OS.BuildVersionCodes.Lollipop . Referring to the Android version table at the beginning of this guide, we see that the build version code for Android 5.0 Lollipop is Android.OS.BuildVersionCodes.Lollipop . ��� ��������� ����� ������ ������ Android, ����� SetCategory ����������, ��� ��� ����� ���������� ������� API �� ����� ���������� � ������� ������� ����� SetCategory ������ � ��� ������, ���� ������� API ������ ��� ����� ���� ������ ������ ��� �������� ��������: To support older versions of Android where SetCategory is not available, our code can detect the API level at runtime and conditionally call SetCategory only when the API level is greater than or equal to the Lollipop build version code:

� ���� ������� ��� ����� ������� ��������� ���������� ������ �������� android 5,0 (API ������ 21) , � ��� ����������� ������ Android � Android 4,1 (������� API 16) . In this example, our app’s Target Framework is set to Android 5.0 (API Level 21) and its Minimum Android version is set to Android 4.1 (API Level 16). ��������� SetCategory �������� �� ������ API Android.OS.BuildVersionCodes.Lollipop � ����� ������� ������, ���� ������ ���� ����� �������� SetCategory ������ �����, ����� �� ������������� �������� � �� �� ����� �������� �������� SetCategory , ���� ������� API ����� 16. , 17, 18, 19 ��� 20. Because SetCategory is available in API level Android.OS.BuildVersionCodes.Lollipop and later, this example code will call SetCategory only when it is actually available � it will not attempt to call SetCategory when the API level is 16, 17, 18, 19, or 20. ��� ������� � ���������� ������� Android ����������� ������ �� ���� ��������, � ������� ����������� �� ����������� ������� ������� (��� ��� ��� �� ���������������� �� ����), �� ����������� ��-�������� ����������� ��� ���������� ������������. The functionality is reduced on these earlier Android versions only to the extent that notifications are not sorted properly (because they are not categorized by type), yet the notifications are still published to alert the user. ���� ���������� ��-�������� ��������, �� ��� �������������� ����������� ������� �����������. Our app still works, but its functionality is slightly diminished.

��� �������, �������� ������ ������ �������� ������ ���� ��������� �� ����� ���������� �������� �� ��������� �� ������ ��������. In general, the build version check helps your code decide at runtime between doing something the new way versus the old way. ������: For example:

��� �������� � �������� �������, �����������, ��� ��������� ��� �������� ���������������� ���������� ��� ������� � ����� ������ ������� Android, � ������� ����������� ���� ��� ��������� API-�����������. There’s no fast and simple rule that explains how to reduce or modify your app’s functionality when it runs on older Android versions that are lacking one or more APIs. � ��������� ������� (��������, � ����������� ���� ������� SetCategory ) ���������� �������� ����� API, ���� �� ����������. In some cases (such as in the SetCategory example above), it’s sufficient to omit the API call when it’s not available. ������ � ������ ������� ����� ������������� ����������� �������������� ���������������� ��� �������, ����� Android.OS.Build.VERSION.SdkInt �������������� ������ ������ API, ������������ ���������� ��� ����������� ��� ������������ ��������������. However, in other cases, you may need to implement alternate functionality for when Android.OS.Build.VERSION.SdkInt is detected to be less than the API level that your app needs to present its optimum experience.

������ API � ���������� API levels and libraries

��� �������� ������� ���������� Xamarin. Android (��������, ���������� ������� ��� ���������� ��������) ����� ��������� ������ �������� ������� ��������� � ����������� ������ Android � ��������� ������� ������ Android ����������. When you create a Xamarin.Android library project (such as a class library or a bindings library), you can configure only the Target Framework setting � the Minimum Android version and the Target Android version settings are not available. ��� ������� � ���, ��� ����������� �������� ��������� Android : That is because there is no Android Manifest page:

��� �������� ������� ���������� Xamarin. Android ��� �������� ���������� Android , �� ������� ����� ��������� ����������� ������ Android � ������� ������ Android � ����������� ������ Android � ��������� ������� ������ Android �� �����. When you create a Xamarin.Android library project, there is no Android Application page where you can configure the Minimum Android version and the Target Android version � the Minimum Android version and Target Android version settings are not available. ��� ������� � ���, ��� ����������� �������� ������ > ���������� Android : That is because there is no Build > Android Application page:

��������� ����������� ������ Android � ������� ������ Android ����������, ��� ��� �������� ���������� �� �������� ���������� ����������� � ���������� ����� ���� �������� � ����� ������ Android � ����������� �� ����������, � ������� ��� ���������. The Minimum Android version and Target Android version settings are not available because the resulting library is not a stand-alone app � the library could be run on any Android version, depending on the app that it is packaged with. ����� ������� ������ ��������������������, �� ������ �����������, �� ����� ������ API ��������� ����� ����������� ����������. You can specify how the library is to be compiled, but you can’t predict which platform API level the library will be run on. �������� ���, ��� ������������� ��� �������� ��������� ������� ��������� ��������� ������������. With this in mind, the following best practices should be observed when consuming or creating libraries:

��� ������������� ���������� Android � ���� � ���������� ������������ ���������� Android, ���������, ��� ��������� ������� ��������� ���������� ��������� �������� ������ API, ������� �� ������ ������������� �������� ��������� ������� ��������� ����������. When consuming an Android library � If you are consuming an Android library in your application, be sure to set your app’s Target Framework setting to an API level that is at least as high as the Target Framework setting of the library.

��� �������� ���������� Android � ���� �� �������� ���������� Android ��� ������������� ������� ������������, ���������, ��� ��� ��������� ������� ��������� ����� ����������� ������� API, ����������� ��� ����������. When creating an Android library � If you are creating an Android library for use by other applications, be sure to set its Target Framework setting to the minimum API level that it needs in order to compile.

��� ������������ ������������� ������������ ��� �������������� ��������, ����� ���������� �������� ������� API, ������� ���������� �� ����� ���������� (��� ����� �������� � ���� ����������). These best practices are recommended to help prevent the situation where a library attempts to call an API that is not available at runtime (which can cause the app to crash). ���� �� ����������� ����������, ��� ������� ���������� ������������� ������� API ��������� � ������ ������������� ������������� ����� ���������� ���� API. If you are a library developer, you should strive to restrict your usage of API calls to a small and well-established subset of the total API surface area. ��� �����������, ��� ���������� ����� ����� ������������ � ����� ������� ��������� ������ Android. Doing so helps to ensure that your library can be used safely across a wider range of Android versions.

udm_api_version

(PHP 4 >= 4.0.5, PHP 5 = 1.0.0)

udm_api_version � Get mnoGoSearch API version

Description

Gets the mnoGoSearch API version.

This function allows the user to >udm_get_doc_count() function is only available in mnoGoSearch 3.1.11 or later.

Return Values

udm_api_version() returns the mnoGoSearch API version number. E.g. if mnoGoSearch 3.1.10 API is used, this function will return 30110.

Examples

Example #1 udm_api_version() example

��� ����� API? ������� ���������� ��� ����������

���� ������� ������ �� ����� � ����, ��� ���� ���-�� ����������� � �����������. �� ������ �� ��� ��������, ��� ������ �� ���������� � ����� �����. ����������� ϸ�� ������� ��������� �� API �������� ������� � ���� �����.

������������ API ���������������� ��� �Application Programming Interface� (��������� ���������������� ����������, ����������� ��������� ����������). ����������� ������� �������� �� ����������� ����� ������������� API ��� �������� ��� ��� ����������� �������������. ����� ������, ��� � ����� ������� API ����������� � ���������� � �������, ������� ����� �����������, ��� �������� ���������� �������.

��������� ������� � �������� �������

WWW ����� ����������� ��� �������� ���� ��������� ��������, �� ������� � �������� ������ ��������. ������� ������� ����� ���������� � ������, ��������� ����������� ����� ���� � ����, � ��������� ������� ������������ ���������� ��� �������� ������ ����� ���, ��� ������� �� ��� �������� ����� �������������.

��� �������� � �������� ������ �������� www.facebook.com �� �������� ������ Facebook ������������ ��������������� ������. ��� ������ ������� �������� �����, �� �������������� ��� � ���������� ��������.

������ ���, ����� ������������ �������� �����-���� �������� � ����, �� ��������������� � API ��������� �������. API � ��� ������������ ����� �������, ������� �������� ������� � ���������� ������.

API ��� ������ ������������ ��������

������ �������� ���������� API ��� ������� �������. ��������, Weather Underground ������ ������ � ������ API ��� ��������� ����������������� ������.

�������� �������������: �� ����� ��������� �������� ���� ����� ��� ������ �������� �� ����. �������� ����� �������� � ���� Google ���������, ����� ���� �������� ����������� ������������� ��������� ������� � ������� ������ � ����������� �������.

���������� API: ���� � ������ ����� ������ �������� ���������� � ������� Google � �������� �� �������� ������� � ���������� ��������, �������� ����� Google, ������������ ���, � ���������� ��������������� ���������� � �������, ��������, ��������� � �������� �� ������������� ������������.

� �������� ������������ ������� ����� ������� ������ � API ������� Google, ����� ������ ��������.

��� API Google ��������� ���������� �� API ������ ������� ��������� ������� � ����?

����������, ������� � ������� ������� � ������. ����� ������������� ������ ���-��������, ������� ������� ����� �� ����� �������� HTML, � �� ����� ��� API Google ��������� ����� ������ ������ � ������� ����� JSON.

���� ������ � API ������ ������ ���-����� ��������, �� �� � �������� �������� (��� ��, ��� �������� ��������� �������, ����� ������������ ��������� ���-����).

������������ ��������� API �������� ����������� ��������� ��������, �� ������� ���� ��������.

����������� ����������� ������ ���������� �� ������� ���� ��������� ��������� API. ������ ������ ��� ����� ������� �������, ������������ ���������� ��������������, ���� �� ���������� ��� ������. �������� ����� � ������� ���������� ������ � ��� �������� �������.

������ ������������ �������� ���������� �� ��������� ��������, ������� ��������������� ����� ����� ��� ������ API. �������, ������� ��������� ��������������� ������� �� ��������� � �������� ������� ����������, ���������� ��������������.

����� �������, ����� �������� ���������� ����� ������������� API, ��� ������ ��������, ��� ��� ������� ��� ����������� URL, ������� � �������� ������ ���������� ������ ������.

����� ������� ����� ����� ���������� ����� �������. ��� ��� �������� ������ �� ��������� HTTP ���������� � ��������� ����, ������� ������ ������ ���������� �����. ��������, ����� ������� ����� �������� ���������� � API GitHub (https://api.github.com/users/petrgazarov), ������ ��� ������� �������, � �������� ��� ����� ����� � ������� JSON:

������� ������� ���������� JSON-�����, ������� ������ ����� ��������� � ���. �� ������ ������ ���������� ������ ������� ������, ����� ������������ �� �� ������ ����������.

��� ��������� �������� API

����� �application� (����������, ����������) ����� ����������� � ������ ���������. � ��������� API ��� �������������:

  • �������� ������������ ����������� � ����������� ��������,
  • ������ �������, ���������� ������� ��� �� ������ ��������� ����� ����������.

����� �������� ��, ������� ����� ����� �������� �� ���������, ����� �������� ����� ��� � ������������ ������������, � ���� ����� ����� ���������� ���� API. ��������, ��� ��������� � ��� ������������� ��������� ����������, ��� ���������� ������ ����� ����������. ������ ��������������� ���������� ��, ���������� ����� ����� ����� API, ������� �������� �� ����������������� � ��������� ����� ����������.

� ��������-��������������� �������������� ��� ����������� � ���� ������������ ��������. � ���������� ����� ��������, ����������������� ����� �����, ����� ���� �����. � ������� �� ��� ���� ���� API � ����� ��������� ������� � ������� ��� �������������� � ������� ��������� � ����������. ������� ����� ����� ����� �������, ���������� ������, ������� ������ �� ��������� � �� �������� API.

DATA API

����������

������� ��������� ���������� ��� ������������� Data API:

  • ������ ���� ������ ������������ � ������ �� ��������� null . � ������ ������� ������������ ������ ������, � ������ ������� ������������ ������ ������;
  • ��� ���� ��������� � ����� � �������� ���������� � ������� YYYY-MM-DD hh:mm:ss;
  • ������� � API ����������� ������ � ������� ������ POST;
  • ��� ��������� � ��������/�������, � ����� � ���������� ������ � ������� JSON � �������� ������� ��������� � ����� Snake Case — ���������� ���� ����� ������ �������������;
  • ������ ������������ ������ � JSON ������� �������� ������������ RFC 7159. ��������� Accept ������������;
  • ��������� ������ UTF-8;
  • ��������� Content-Type ������ ���� «application/json; charset=UTF-8» ;
  • ��������� Content-Length ������ ��������� ���������� ����� ���������, ������ ������������ HTTP/1.1

�������� IP-����� � ������ �����������

�� ��������� ������ � API �������� ����, ����� ����� ���� ������ ������� ���������� IP-����� ����� � �������� �������� ������ �������� � ����� ������. ��� ����� ������� ����� ������ ������� «������������� -> ������� -> ������� � ��������� ������������» ������� «API».

���� ���������� ��������� ������ ���� IP-�������, �� ����� �������� � ������ ����������� 0.0.0.0/0

���� ������ �������� �� ��� ������, �� ��� IP ����� ������ ���� �������� � ����� ������ ����������� ��������

������������ API � ��������������

� ������������� � ������ ������� ����������� ����� ������� ����������� ������ ������� � ������ ��������

������ �� �����

����� ������������ �� ������ ������������ � ������� ������� �������� «�������» > «���������� ��������������»
���������� ��� ���� ������:

���������� ���� ����� �������������� ����� ��������.
��������� ���� ����� ���������� ���� ��������� �������� �����.

������ �� ������ � ������

������������ �������������� � �������������� ������

����� �� �������� � API

� ������ �������� «������»->»���������»->»������� � API» ����� ��������� ����� �� �������� � API

������� URL ��� ������� � API

������� URL ��� ������� � API ������������� ���������� �������:

— https;

  • — api.comagic.ru, api.uiscom.ru;
  • — ������ API (��. ������ ������������)
  • ������������

    ������� ������ Data API 2.0

    Data API ������������ ������������. ������ ����������� � ������� URL ��� vX.Y , ��� X — ����� �������� ������, Y — ����� �������� ������

    ���� ���� �������� ����� ������, �� ������ ��������� ���������� � �������������� ��� ��������� � ������ ������ API � ����-���������� (��. ������ ����-���������) ����� ������������ �������� «current_version_deprecated» �� ��������� «true»

    ������������ ���������� �������������� ������ — 2
    ������ ��������� ���������� ������ 2 ������

    ������ � �����������

    ����� ����������� ������ �� �������� �������, �.� � ������ �� �������� � API (��. ������ ����� �� �������� � API) �� ������� ��� ��������.

    ���������� � ������� ������������ �� ���� ������� � ����-��������� (��. ������ ����-���������) ����� ������� ����� ������ �� �����������;

    ������ ��������� �� ������� �������, �.� ������ ����� ����� ���� ���. ����� ������ ��������� ��������� �������/�������� ����� �� ������ ���� ����������� ������

    ���������� � ������� � ����-����������:

    �������� ��������� ��������
    day_limit ������� ����� ������ � ����
    day_remaining ����� ���������� ������ �������� �� ���������� �������� ������
    day_reset ����� � �������� ����� ������� ������� ����� ����� �������
    minute_limit ������� ����� ������ �� ������
    minute_remaining ����� ���������� ������ �������� �� ���������� ��������� ������
    minute_reset ����� � �������� ����� ������� �������� ����� ����� �������

    ������ � �� ��������� � ������

    ��� �������� ��������� � ������
    ��� �������� 1

    ���������� �������

    �� �������� «�������» -> «������ � �����» � ������ �������� ����� ��������� ������.

    ��������� ������

    ��������� ��������� �� ������

    �������� ��� ������������ ��������
    error object �� ������ � ���������� ������
    code number �� �� ���������� ��� ������ (��. ������ ������ ����� ������ )
    message string �� C�������� �� ������
    data object �� ������ � �������� ������
    mnemonic string �� ���������� ��������� ��� ������. ��� ��������� ������ ������������� ������������ ���� ��������.
    value string ��� �������� ��, ��� ������� ������������ ��� ���������

    � ��������� ������� ����� �������������. � �������, ������������ �������� ������ �� ��� ��������.

    extended_helper string ��� ������ �� ����� ��������� �������� ������ � ��������� ������� params object ��� ����� ����������� ���������� ��� ������� � ������� �� ������. �.�. �������� ����������� ���������� ��������, � �������, ������. �������� ��������� � ���� ��������� ����� ���� ������������ � ���������� �� ������� � ����������, ������� ���������� �� Data API. field string ��� �������� ���������, � ������� ������� ������

    ��������� ��������� ������������ ����� ����������� ����� «.»
    � �������: «employee.phone_number»

    JSON ��������� ������

    ������ ����� ������

    ��� ������ ��������
    -32700 ������ ��������� � ���������� JSON
    -32600 ������ ��������� � ���������� ���������� ������� — id , jsonrpc
    -32601 ������ ��������� � �������
    -32602 ������ ��������� � ���������� ���������� � ���������� ������
    -32603 ���������� ������ JSON RPC �������
    -32001 ������ �������������� � ������ � �������
    -32003 ������ � ������� ������� — ip ����� �� � ����� ������, ��� ���� � ������������
    -32004 ������ ��������� � �������� ������������������� ���������� �������
    -32007 ������ ��������� � ����������� �������
    -32008 ������ ��������� � ������������
    -32009 ������ ��������� � ���������
    -32029 ������ ��������� � ��������
    -32099 ������ ��������� � ���������� ��������� ������ ������������ JSON RPC 2.0 — ��������� ��������, �����������

    ������ ������ ����� ��� ���� �������

    ����� ��������� ��� ��������� ��������
    Invalid Request The JSON sent is not a valid Request object -32600 invalid_request ������ ��������� � ���������� ���������� ������� — id , jsonrpc
    Access token has been expired -32001 access_token_expired ����������� ������ � ����������� ������. ���� ����� ����� ����������� ������ �������, �� ������������ ��������� ������
    Access token has been blocked -32001 access_token_blocked ���� ���������� ����� ������������, �� ������������ ��������� ������
    Access token is invalid -32001 access_token_invalid ��������� ������ ������������ ���� ����������/��������� ����� �� ������
    Limit per has been exceeded. Value of current limit per is -32029 limit_exceeded ����� ��������
    You need at least on of the following components to access this method: -32008 method_component_disabled ���� �� ��������� ���������, ������� ��������� ��� ������ ������
    You need at least on of the following components to access this paremeter: -32008 parameter_component_disabled ���� �� ��������� ���������, ������� ����� ��� ���������� ��������� � �������� ��������
    Your IP is not whitelisted -32003 ip_not_whitelisted IP ����� � �������� �������� ������ �� ��������� � ����� ������ �������. ���� ������ �������� �� ��� ������, �� ��� IP ����� ������ ���� � ������� ���������� ������� ������ ����������� ��������
    Login or password is wrong -32001 auth_error ������������ ����� ��� ������
    Your account has been disabled, contact the support service -32009 account_inactive ������� ������������
    Internal error, contact the support service -32603 internal_error ���������� ������, ���������� ���������� � ������ ����������� ���������
    Data supplied is of wrong type -32602 data_type_error � �������, ���� ������� string � �������� int
    The method does not exist / is not available -32601 method_not_found ���������� ����� �� ������
    Permission denied -32003 forbidden ��� ���� �� ������ � ������ ��� API, ��� ��������� ��������� �����-���� ��������
    Invalid JSON was received by the server. -32700 parse_error ������ ��������� JSON
    Batch operations not supported -32099 batch_opreations_not_supported ��������� �������� �� ��������������
    Notifications not supported -32099 notifications_not_supported ��� ������� �������� id � �������. ��. ������ ����� ��������� ��� ���� �������»
    The required parameter has been missed -32602 required_parameter_missed ������������ �������� �� ��������
    Invalid parameter value -32602 invalid_parameter_value ������������ �� ���� �������, ���� ���� �������� ������������ �������� ��������� ��� ���������� �������� �� ������������� ���������� ������� �����
    Unexpected method parameter(s) -32602 unexpected_parameters ���� � «params» ���� �������� ��������� ������� �� ������������� JSON ���������� ������ ��� ������ �������� ��� ����������, ���������� � �������, ������� �� ����������
    The combination of parameters is not permitted -32602 invalid_parameters_combination ���� ��������� ��������� � ������ ��������� � ������������ ���������� ��� ����� ���������� ���� �� �����. ����� �������� ������������ �� ������ � ��� ����������.
    -32602 error ������������ ������

    ������ ������ ��� ������� � �������� get

    ����� ������ ��� ��������� ��������
    Invalid parameter value -32602 invalid_parameter_value ���� � �������� ���� �������� ������������ �������� ��� regexp, jsquery ��� ����� �������� �� ��������������� ������������
    Sort by parameter is prohibited -32602 sort_prohibited ���������� �� ��������� ��������� � ����������, ��� ��� �������� ��� ���������� �� ��������� � ������ ����������� ��� ����������
    Filter by parameter is prohibited -32602 filter_prohibited ���������� �� ��������� ��������� � ����������, ��� ��� �������� ��� ���������� �� ��������� � ������ ����������� ��� ����������
    Max value of requested date interval is 3 months -32602 date_interval_limit_reached ���� � ������� ������ ����� ���������� ������ � date_from � date_till ��������� 3 ������. � �������� ������ ��������� ������ ��� ������� ��������� �������, �� �� ��� ����.

    ������ ������ ����� ��� ������� � �������� delete

    ����� ������ ��� ��������� ��������
    Entity not found -32602 entity_not_found ���� ������� ���������� ������������� ��������, ������� �� �������
    You have interdependet entities -32602 dependency_error ��������� �������� ������������ � ������ ���������. ����� �������, ���������� ������ ��������� �������� �� ���� ��������� ���� ��� ��� ������������
    Permission denied -32602 forbidden ������� �������� ���������� ��� ��� ��� ���������, � ������� ������ «������ ������» � �������� �����

    ������ ������ ����� ��� ������� � �������� create � update, set, unset

    ����� ������ ��� ��������� ��������
    Entity not found -32602 entity_not_found ���� ������� ���������� ������������� ��������, ������� �� �������
    Duplicate entity -32602 duplicate_entity ���� �������� ��� ����������
    A new data limit has been exceeded -32602 data_limit_exceeded ������ ��������� � ������, ���� ���� ���������� ������������ ���������� ������.
    Action is not allowed for your tariff plan. You need contact support service or change your tariff plan settings in your account -32602 tariff_restrictions ����� ����������� ��������� �����
    This value is already used by another entity -32602 already_in_use �������� ���������� ��������� ��� ������������ � ������ ��������. � �������, ����������� ����� ��� ������������ � ������ ��������� ��������.

    ��������� ��������

    ���������� �� ��������������

    ������� ���������� �������

    ��� JSON-RPC ������ ������� �� ���� ������ ����������� ������: ������� � ����� �������.

    ��� ������� ���������� ��� ��������������� �� ������������� �����, ���������� ������-��������, �������� subscribers .

    ��� ������ ������ ���������� � �������, ����������� ���� ��������.

    ������� ������������ � ���������� �������

    ������ ��������
    create ��������� ��������.
    get ���������� ������ ��������������� � ��������������� ������ � ������� ��������� ���������� � ������� ����������. � ������� �������� ��������� ����� � ������������ ����� �� ���������� ���������� ������ (��. ������ ������������ �����). � ������� ��������� ���������� ����� ���� ��� �� �������� ���� ������, �� �� ����������� �������������� (��. ������ �������� ����������). � ����������� ����-��������� ������������ ����� ���������� ������� (��. ������ ����-���������). � ������� ������������ ��������� ����� ������� ����� ���� ���������� � �������� ��������� (��. ������ ������������� ������������ ������).
    update ��������� �������� � ����������� ���������������.

    �������� ��������� ���������� ����������
    ��� ���������� �������� ����������� ���� ������ �������, �.� ��� �������� ������� �� ���� �������� ���������.
    ��� ��������� ��������������� ��������� ����� �������� null

    delete ������� �������� � ����������� ���������������. add ����� ������ ������� � ������. enable ����������� ������� disable ���������� ������� set ����������� �������� �� ������ ������, � �������, ��������� ���� �� ��������� unset ������ �������� � ������� ������, � �������, ������ ���� � ���������

    �������� ����������

    ���������� ������ ����������� ������ � ������� «get» (��. ������ «������� ������������ � ���������� �������» � ������� ��������������� ��������� «filter» , ������� �������� �������� � ����� ���������:

    1. ������� ������;
    2. ������ �������� ������� �������� ������� ������� � ���������.

    ������� ������ — ��� ������, ������� �������� � ���� ������������ ���������:

    • field — ���� �������� � ������� ����� ����������� ���������� (������ ������� �������� ��� ������);
    • operator — �������� ����������. ������ ���� ���������� ����� �������� � ������� «��������� ����������»;
    • value — �������� ��� ��������� ����������. �������������� ����, ���� ��� �����������, �� ��������� �������.

    ������ �������� �������� ����������� �������� «filters» , ������� ����� ��������� � ���� ��� ������� �������, ��� � ������ ��������.

    ��������� ������ ��� ����������

    ����� ��� ��������� ��������
    Filter by parameter is prohibited -32602 filter_prohibited ���������� �� ��������� ��������� � ����������, ��� ��� �������� ��� ���������� �� ��������� � ������ ����������� ��� ����������
    Unexpected method parameter(s) -32602 unexpected_parameters ������� ��������� �������� ��� ��������, �������� �� ����������

    ������ JSON ��������� �������� �������

    �������� ������ ������� � ������� ���� «name» ����� ��� «Bob»

    ������ JSON ��������� ������ �������� � ����� ������� �����������

    �������� ������ ������� � ������� ���� «name» ����� ��� «Bob» � ��� ������� 25 ���

    ������ JSON ��������� ������ �������� � ������� ������� �����������

    �������� ������ ������� � ������� ���� «name» ����� ��� «Bob» � ��� ������� 25 ��� ��� ������ ������� � ������� ���� «name» ����� ��� «Dexter» � ��� ������� 2 ����

    ������ JSON ��������� ������ �������� � ������� ������� �����������

    ������� ������� ((addv_comp_ >

    ��������� ����������

    ���������� null � not null ����� =null, !=null

    �������� �������� ���� �������� ����� ��� ������
    = ����� �� number, string, null, boolean, iso8601, enum
    != �� ����� �� number, string, null, boolean, iso8601, enum
    ������ ��� number, iso8601
    > ������ ��� number, iso8601
    ������ ��� ����� number, iso8601
    >= ������ ��� ����� number, iso8601
    like ���������� �, ������������� ��, ��������
    �� string regexp Posix �� string jsquery PostgreSQL jsquery �� object, array in ������ �������� � ��������� «or» �� number, string, enum

    ���������� ������

    ���������� ������ ����������� ������ � ������� «get» (��. ������ «������� ������������ � ���������� �������») � ������� ������� �������� ���������� �� ���������� �����������:

    • field — ���� �� �������� ������������ ����������;
    • order — ����������� ����������. ��������� �������� «asc» / «desc» . «asc» — �� �����������, «desc» — �� ��������. �������� ������������. �������� �� ��������� «as�» .

    ������ ����� �� ������� ����� ����������� ���������� ������������ ������������� ��� ������� ������.

    ��������� ������ ��� ����������

    ����� ������ ��� ��������� ��������
    Sort by parameter is prohibited -32602 sort_prohibited ���������� �� ��������� ��������� � ����������, ��� ��� �������� ��� ���������� �� ��������� � ������ ����������� ��� ����������
    Unexpected method parameter(s) -32602 unexpected_parameters ������� ��������� �������� ��� ��������, �������� �� ����������

    ������������ �����

    ������������ ����� ����� ���� ������� � ������� «get» (��. ������ «������� ������������ � ���������� �������»). ��� ���������� ��������� ������ ������������ ��������� ���������:

    �������� �������� �� ��������� ���������� �������� ��������
    offset 100 000 �����, ���������� � ������ ������ ������ ���������� «limit» �������
    limit 1000 10 000 ������ ������������ ������ (���������� �������)

    ����-���������

    ������������ ��� ������������� ������� «get» (��. ������ «������� ������������ � ���������� �������»).

    ������������ ��� � ���������, ��� � � �������� ������

    �������� «api_version» ������������ ������ ��� ������ ������� deprecated.

    ������������� ������������ ������

    ��������� ������ ������������ ��������

    � ������� ��������� ������ «get» (��. ������ «������� ������������ � ���������� �������») ����� ���� ������ ����������� �������������� �������� «fields» � ����� ������, ������� ����� ��������� ������ ����� ������� ���������� �������� � ������. ���� �������� «fields» �� ������������, �� � ������ ������������ ��� ���� �� ��������� ��� ����������� ������.

    ������ ����� ������������ ��� ������� ������.

    ��������� ������ � ������������� ������������ ������

    ����� ��� ��������� ��������
    Unexpected method parameter(s) -32602 unexpected_parameters ������� ��������� �������� ��� ��������, �������� �� ����������

    ����� ���� ��� ���� �������

    �������� ��� ������������ ���������� �������� ��������
    id string ��� number �� ���������� ������������� ������� � API, ������� ������������ ��� ����� ������� � �������. ������������� ������ � ���� ����������� ���� ��� ���������� ����� .
    method string �� ���������� �����
    jsonrpc string �� 2.0 ����� ������������ JSON-RPC
    params object �� �������� ���� ������� � API. � ����������� �� ����������� ������ ���� ������� ��������.

    ��������������

    ����� login.user
    �������� ���� � ��������� ����� ������ ��������������
    ���� �������� ������, ������

    ��������� �������

    �������� ��� ������������ ���������� �������� ��������
    login string �� ����� ������������
    password string �� ������ ������������

    ��������� ������

    �������� ��� ������������ ��������
    access_token string �� ���� ������ ��������������
    expire_at number �� Timestamp ����� �������� ����� ���������� ���� ��������
    app_id number �� ���������� ������������� �������

    ����� ����� ����������� ����� ������ �������������� ����� ������ ������ «login.user» — 1 ���. �� ��������� ������� ����� ����� ������ ��� ���������� ����������� ������, �.�. �������� ����� «login.user» .

    ��� ���������� �������� � API �������� ������������� ����������� ����� ��������������, ������� �������� � ������ �������� �� ������ ������������.

    udm_api_version

    (PHP 4 >= 4.0.5, PHP 5 udm_api_version � Get mnoGoSearch API version

    Description

    Gets the mnoGoSearch API version.

    This function allows the user to identify which API functions are available, e.g. udm_get_doc_count() function is only available in mnoGoSearch 3.1.11 or later.

    Return Values

    udm_api_version() returns the mnoGoSearch API version number. E.g. if mnoGoSearch 3.1.10 API is used, this function will return 30110.

    Examples

    Example #1 udm_api_version() example

    ����� �����

    ���������� ���� ��������� �������� ����� ������� ����� � ������. ���������� ������������ �������� 55 ��� ������������� � ����� � ���������� � ����������� ���������� ���������. � ���, ��� ���������� ���� ������ � ���� ���������� ���� ��������� ��� �����. �� ������� ������� ������������ �������� ����������, ����� �� ��� ���������������� � ���� � ��������� � ������ ������� ��� ��� ������. �� ������� ��������� ����� ���������� ��������.

    �� ��������� ����� ������� ����������, �������, ��� ��������� ��������� ��� �������� ����� ��������/������ ��� ������ ����� ���� ���������, ��� �, ��� �����, ���� � ��� ��� ����� � �������� ���������.

    ��� ������ �������� ������ ������������ ������������� ����� ������.

    �������� ��������� �� ������� ������ � �����.

    ��������� � ��������� � ��� �� ���-�� �����������, ����������� ���� �� ����. � ������� B2B ���������� ���������������� �������, ����������� ��������� ������� ����� � ����������� ����� ��������, � ������, ������� ��������� � ��������� ����� ������.

    ��� ����� ������� �����, ��� ���� ������� � ������������� ���������: � ����������, ����� ��������, PR, �������, �����������, �����������, ��������� � �������������� ������� � �. �.

    ����� ���������� ����, ��� ����� ��������� ������������ ��� �������, ��������� ����� ������ � ����������� ��������� �� ��� �����.

    udm_api_version

    (PHP 4 >= 4.0.5, PHP 5 = 1.0.0)

    udm_api_version � Получает версию mnoGoSearch API

    Описание

    Получает версию mnoGoSearch API.

    Эта функция позволяет пользователю узнать, какие функции API доступны, например, функция udm_get_doc_count() доступна только в mnoGoSearch 3.1.11 или выше.

    Возвращаемые значения

    udm_api_version() возвращает номер версии mnoGoSearch API. Например, если используется mnoGoSearch 3.1.10 API, эта функция вернет 30110.

    Примеры

    Пример #1 Пример использования udm_api_version()

    udm_api_version

    (PHP 4 >= 4.0.5, PHP 5 = 1.0.0)

    udm_api_version � Get mnoGoSearch API version

    Description

    Gets the mnoGoSearch API version.

    This function allows the user to >udm_get_doc_count() function is only available in mnoGoSearch 3.1.11 or later.

    Return Values

    udm_api_version() returns the mnoGoSearch API version number. E.g. if mnoGoSearch 3.1.10 API is used, this function will return 30110.

    Examples

    Example #1 udm_api_version() example

    Илон Маск рекомендует:  Что такое код sort
    Понравилась статья? Поделиться с друзьями:
    Кодинг, CSS и SQL