Archive with example contains SDK CRest, SDK CRest modifications for simplified variant of OAuth 2.0 use and a single file, both comprising a finalized application, querying REST API and showing current user Full name. Other example of such application is described in the lesson REST for SMS.
Attention! This example works based on SDK CRest. Before using this example, open the file checkserver.php via browser and check if your server settings are correct. You need to inherit CRest class for actual public application by re-defining methods getSettingData/setSettingData, that are get/save authentication tokens into text file. These methods are not intended for app operation on several Bitrix24 simultaneously. Learn more.
Download the archive:
To create a solution to be further published in Application catalog, select
New application
and choose an area for publishing your future new app inside your own developer's account. The new slider menu allows you to
choose or create
a new app version:
Fill out the available sections (1) for this example by inputting "Users".
Contrary to local applications, public apps have versions. Each version is submitted for moderation. (During moderation, app description is checked as well). Moderation is not required at the development and testing stage, you are developing and finalizing your app's fully featured package, including test instances on your Bitrix24 accounts and only after that you should submit your app to be moderated by Bitrix24 team.
When creating a new solution you need to fill out the app name (1) and app ID code, categories (2), app description (3), price policy (4) and click test (5):
Description of required fields (click on plus symbol)
Contrary to local applications, each public app must have a unique character ID code. This code consist of two parts: your unique partner ID (indicated inside partner's account) and part you assign to a specific created application (2 see image above).
Note: your app ID code must be clear and legible from the very start. Please, be aware that this specific code will be a part of your app's public address in Application catalog and you won't be able to replace it later.
To simplify things, you can temporarily indicate that your app is free of charge (5). Later, before submitting this app to moderators you can change this status and update other descriptions accordingly.
Click on a block with one of languages in Application description (4) and fill out the required fields with descriptions, as well as upload solution logo and at least one screenshot. It's not absolutely required to input actual and finalized descriptions as well as final screenshots of the app at the development stage. However, later on when you decide to submit a completed and debugged solution application to Bitrix24 moderators to be published in Applications catalog, these fields must be filled out with actual full information.
From the very start, you can choose a category for your app (3). Such categories help users to navigate in the
Applications catalog
.
Proceed to saving app details, by filling all the required fields. First step is complete, i. e. you have prepared description portion of your future application.
Application testing
To test your application, click on
Test button in the app version
or
Test inside the app
:
When Bitrix24 app installation is complete, its interface opens right away. You can also switch to the app from the corresponding left menu item or More menu in the Application section. The started application shows debugging information about transferred current user authentication data, as well as current user full name, retrieving it via REST API. The app gets such data via REST API using the authentication data. Because this application works within Bitrix24 interface and uses authentication of current user who has opened this app, the app works exclusively within this user access permissions.
