{"id":10216,"date":"2023-12-20T13:58:40","date_gmt":"2023-12-20T09:58:40","guid":{"rendered":"https:\/\/vita-xpro.com\/?post_type=docs&#038;p=10216"},"modified":"2024-12-03T11:01:58","modified_gmt":"2024-12-03T07:01:58","password":"","slug":"authentication-2","status":"publish","type":"docs","link":"https:\/\/vita-xpro.com\/ar\/docs\/authentication-2\/","title":{"rendered":"Authentication"},"content":{"rendered":"\t\t<div data-elementor-type=\"wp-post\" data-elementor-id=\"10216\" class=\"elementor elementor-10216\">\n\t\t\t\t\t\t<section class=\"elementor-section elementor-top-section elementor-element elementor-element-56905b8b elementor-section-boxed elementor-section-height-default elementor-section-height-default\" data-id=\"56905b8b\" data-element_type=\"section\">\n\t\t\t\t\t\t<div class=\"elementor-container elementor-column-gap-default\">\n\t\t\t\t\t<div class=\"elementor-column elementor-col-100 elementor-top-column elementor-element elementor-element-347c6cb\" data-id=\"347c6cb\" data-element_type=\"column\">\n\t\t\t<div class=\"elementor-widget-wrap elementor-element-populated\">\n\t\t\t\t\t\t<div class=\"elementor-element elementor-element-25bb69f elementor-widget elementor-widget-spacer\" data-id=\"25bb69f\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t<style>\/*! elementor - v3.21.0 - 26-05-2024 *\/\n.elementor-column .elementor-spacer-inner{height:var(--spacer-size)}.e-con{--container-widget-width:100%}.e-con-inner>.elementor-widget-spacer,.e-con>.elementor-widget-spacer{width:var(--container-widget-width,var(--spacer-size));--align-self:var(--container-widget-align-self,initial);--flex-shrink:0}.e-con-inner>.elementor-widget-spacer>.elementor-widget-container,.e-con>.elementor-widget-spacer>.elementor-widget-container{height:100%;width:100%}.e-con-inner>.elementor-widget-spacer>.elementor-widget-container>.elementor-spacer,.e-con>.elementor-widget-spacer>.elementor-widget-container>.elementor-spacer{height:100%}.e-con-inner>.elementor-widget-spacer>.elementor-widget-container>.elementor-spacer>.elementor-spacer-inner,.e-con>.elementor-widget-spacer>.elementor-widget-container>.elementor-spacer>.elementor-spacer-inner{height:var(--container-widget-height,var(--spacer-size))}.e-con-inner>.elementor-widget-spacer.elementor-widget-empty,.e-con>.elementor-widget-spacer.elementor-widget-empty{position:relative;min-height:22px;min-width:22px}.e-con-inner>.elementor-widget-spacer.elementor-widget-empty .elementor-widget-empty-icon,.e-con>.elementor-widget-spacer.elementor-widget-empty .elementor-widget-empty-icon{position:absolute;top:0;bottom:0;left:0;right:0;margin:auto;padding:0;width:22px;height:22px}<\/style>\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-5402634d elementor-widget elementor-widget-text-editor\" data-id=\"5402634d\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t<style>\/*! elementor - v3.21.0 - 26-05-2024 *\/\n.elementor-widget-text-editor.elementor-drop-cap-view-stacked .elementor-drop-cap{background-color:#69727d;color:#fff}.elementor-widget-text-editor.elementor-drop-cap-view-framed .elementor-drop-cap{color:#69727d;border:3px solid;background-color:transparent}.elementor-widget-text-editor:not(.elementor-drop-cap-view-default) .elementor-drop-cap{margin-top:8px}.elementor-widget-text-editor:not(.elementor-drop-cap-view-default) .elementor-drop-cap-letter{width:1em;height:1em}.elementor-widget-text-editor .elementor-drop-cap{float:left;text-align:center;line-height:1;font-size:50px}.elementor-widget-text-editor .elementor-drop-cap-letter{display:inline-block}<\/style>\t\t\t\t<p><!-- wp:heading --><\/p>\n<h2 class=\"wp-block-heading\">Authentication<\/h2>\n<p><!-- \/wp:paragraph --><\/p>\n<p><!-- wp:paragraph --><\/p>\n<p><!-- \/wp:paragraph --><\/p>\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-d159258 elementor-widget elementor-widget-spacer\" data-id=\"d159258\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-7bdaa4f elementor-widget__width-initial elementor-widget elementor-widget-text-editor\" data-id=\"7bdaa4f\" data-element_type=\"widget\" data-widget_type=\"text-editor.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t\t\t<p>All requests require the user authentication token in the request header.<\/p>\n<p><strong>1. URL:<\/strong><span>\u00a0<\/span><a href=\"https:\/\/{{host-name}}\/api\/TokenAuth\/Authenticate\">https:\/\/{{Host-Name}}\/api\/TokenAuth\/Authenticate<\/a><\/p>\n<p><strong>2. Method:<span>\u00a0<\/span><\/strong>Post<\/p>\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-0dea3fb elementor-widget elementor-widget-spacer\" data-id=\"0dea3fb\" data-element_type=\"widget\" data-widget_type=\"spacer.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t\t\t<div class=\"elementor-spacer\">\n\t\t\t<div class=\"elementor-spacer-inner\"><\/div>\n\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<div class=\"elementor-element elementor-element-1252be5 elementor-widget elementor-widget-accordion\" data-id=\"1252be5\" data-element_type=\"widget\" data-widget_type=\"accordion.default\">\n\t\t\t\t<div class=\"elementor-widget-container\">\n\t\t\t<style>\/*! elementor - v3.21.0 - 26-05-2024 *\/\n.elementor-accordion{text-align:start}.elementor-accordion .elementor-accordion-item{border:1px solid #d5d8dc}.elementor-accordion .elementor-accordion-item+.elementor-accordion-item{border-top:none}.elementor-accordion .elementor-tab-title{margin:0;padding:15px 20px;font-weight:700;line-height:1;cursor:pointer;outline:none}.elementor-accordion .elementor-tab-title .elementor-accordion-icon{display:inline-block;width:1.5em}.elementor-accordion .elementor-tab-title .elementor-accordion-icon svg{width:1em;height:1em}.elementor-accordion .elementor-tab-title .elementor-accordion-icon.elementor-accordion-icon-right{float:right;text-align:right}.elementor-accordion .elementor-tab-title .elementor-accordion-icon.elementor-accordion-icon-left{float:left;text-align:left}.elementor-accordion .elementor-tab-title .elementor-accordion-icon .elementor-accordion-icon-closed{display:block}.elementor-accordion .elementor-tab-title .elementor-accordion-icon .elementor-accordion-icon-opened,.elementor-accordion .elementor-tab-title.elementor-active .elementor-accordion-icon-closed{display:none}.elementor-accordion .elementor-tab-title.elementor-active .elementor-accordion-icon-opened{display:block}.elementor-accordion .elementor-tab-content{display:none;padding:15px 20px;border-top:1px solid #d5d8dc}@media (max-width:767px){.elementor-accordion .elementor-tab-title{padding:12px 15px}.elementor-accordion .elementor-tab-title .elementor-accordion-icon{width:1.2em}.elementor-accordion .elementor-tab-content{padding:7px 15px}}.e-con-inner>.elementor-widget-accordion,.e-con>.elementor-widget-accordion{width:var(--container-widget-width);--flex-grow:var(--container-widget-flex-grow)}<\/style>\t\t<div class=\"elementor-accordion\">\n\t\t\t\t\t\t\t<div class=\"elementor-accordion-item\">\n\t\t\t\t\t<div id=\"elementor-tab-title-1921\" class=\"elementor-tab-title\" data-tab=\"1\" role=\"button\" aria-controls=\"elementor-tab-content-1921\" aria-expanded=\"false\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon elementor-accordion-icon-right\" aria-hidden=\"true\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon-closed\"><i class=\"fas fa-plus\"><\/i><\/span>\n\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon-opened\"><i class=\"fas fa-minus\"><\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t<a class=\"elementor-accordion-title\" tabindex=\"0\">Request Parameters<\/a>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div id=\"elementor-tab-content-1921\" class=\"elementor-tab-content elementor-clearfix\" data-tab=\"1\" role=\"region\" aria-labelledby=\"elementor-tab-title-1921\"><p>{<\/p>\n<p>&#8220;userNameOrEmailAddress&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;password&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;twoFactorVerificationCode&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;rememberClient&#8221;: true,<\/p>\n<p>&#8220;twoFactorRememberClientToken&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;singleSignIn&#8221;: true,<\/p>\n<p>&#8220;returnUrl&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;captchaResponse&#8221;: &#8220;string&#8221;<\/p>\n<p>}<\/p><\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t<div class=\"elementor-accordion-item\">\n\t\t\t\t\t<div id=\"elementor-tab-title-1922\" class=\"elementor-tab-title\" data-tab=\"2\" role=\"button\" aria-controls=\"elementor-tab-content-1922\" aria-expanded=\"false\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon elementor-accordion-icon-right\" aria-hidden=\"true\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon-closed\"><i class=\"fas fa-plus\"><\/i><\/span>\n\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon-opened\"><i class=\"fas fa-minus\"><\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t<a class=\"elementor-accordion-title\" tabindex=\"0\">200: Success<\/a>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div id=\"elementor-tab-content-1922\" class=\"elementor-tab-content elementor-clearfix\" data-tab=\"2\" role=\"region\" aria-labelledby=\"elementor-tab-title-1922\"><p>{<\/p>\n<p>&#8220;accessToken&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;encryptedAccessToken&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;expireInSeconds&#8221;: 0,<\/p>\n<p>&#8220;shouldResetPassword&#8221;: true,<\/p>\n<p>&#8220;passwordResetCode&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;userId&#8221;: 0,<\/p>\n<p>&#8220;requiresTwoFactorVerification&#8221;: true,<\/p>\n<p>&#8220;twoFactorAuthProviders&#8221;: [<\/p>\n<p>&#8220;string&#8221;<\/p>\n<p>],<\/p>\n<p>&#8220;twoFactorRememberClientToken&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;returnUrl&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;refreshToken&#8221;: &#8220;string&#8221;,<\/p>\n<p>&#8220;refreshTokenExpireInSeconds&#8221;: 0,<\/p>\n<p>&#8220;c&#8221;: &#8220;string&#8221;<\/p>\n<p>}<\/p><\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t<div class=\"elementor-accordion-item\">\n\t\t\t\t\t<div id=\"elementor-tab-title-1923\" class=\"elementor-tab-title\" data-tab=\"3\" role=\"button\" aria-controls=\"elementor-tab-content-1923\" aria-expanded=\"false\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon elementor-accordion-icon-right\" aria-hidden=\"true\">\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon-closed\"><i class=\"fas fa-plus\"><\/i><\/span>\n\t\t\t\t\t\t\t\t<span class=\"elementor-accordion-icon-opened\"><i class=\"fas fa-minus\"><\/i><\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t\t\t<\/span>\n\t\t\t\t\t\t\t\t\t\t\t\t<a class=\"elementor-accordion-title\" tabindex=\"0\">401 \u2013 Unauthorized<\/a>\n\t\t\t\t\t<\/div>\n\t\t\t\t\t<div id=\"elementor-tab-content-1923\" class=\"elementor-tab-content elementor-clearfix\" data-tab=\"3\" role=\"region\" aria-labelledby=\"elementor-tab-title-1923\"><p>{<\/p>\n<p>&#8220;result&#8221;: null,<\/p>\n<p>&#8220;targetUrl&#8221;: null,<\/p>\n<p>&#8220;success&#8221;: false,<\/p>\n<p>&#8220;error&#8221;: {<\/p>\n<p>&#8220;code&#8221;: 0,<\/p>\n<p>&#8220;message&#8221;: &#8220;Invalid user name or password&#8221;,<\/p>\n<p>&#8220;details&#8221;: null,<\/p>\n<p>&#8220;validationErrors&#8221;: null<\/p>\n<p>},<\/p>\n<p>&#8220;unAuthorizedRequest&#8221;: true,<\/p>\n<p>&#8220;__abp&#8221;: true<\/p>\n<p>}<\/p><\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t<\/section>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"<p>Authentication All requests require the user authentication token in the request header. 1. URL:\u00a0https:\/\/{{Host-Name}}\/api\/TokenAuth\/Authenticate 2. Method:\u00a0Post Request Parameters { &#8220;userNameOrEmailAddress&#8221;: &#8220;string&#8221;, &#8220;password&#8221;: &#8220;string&#8221;, &#8220;twoFactorVerificationCode&#8221;: &#8220;string&#8221;, &#8220;rememberClient&#8221;: true, &#8220;twoFactorRememberClientToken&#8221;: &#8220;string&#8221;, &#8220;singleSignIn&#8221;: true, &#8220;returnUrl&#8221;: &#8220;string&#8221;, &#8220;captchaResponse&#8221;: &#8220;string&#8221; } 200: Success { &#8220;accessToken&#8221;: &#8220;string&#8221;, &#8220;encryptedAccessToken&#8221;: &#8220;string&#8221;, &#8220;expireInSeconds&#8221;: 0, &#8220;shouldResetPassword&#8221;: true, &#8220;passwordResetCode&#8221;: &#8220;string&#8221;, &#8220;userId&#8221;: 0, &#8220;requiresTwoFactorVerification&#8221;: true, &#8220;twoFactorAuthProviders&#8221;: [ [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","meta":{"_coblocks_attr":"","_coblocks_dimensions":"","_coblocks_responsive_height":"","_coblocks_accordion_ie_support":"","_eb_attr":"","footnotes":""},"doc_category":[96],"doc_tag":[],"knowledge_base":[],"class_list":["post-10216","docs","type-docs","status-publish","hentry","doc_category-vitaapidocs"],"year_month":"2026-04","word_count":305,"total_views":"1052","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"admin","author_nicename":"vita","author_url":"https:\/\/vita-xpro.com\/ar\/author\/vita\/"},"doc_category_info":[{"term_name":"VITA API Documentation","term_url":"https:\/\/vita-xpro.com\/ar\/docs-category\/vitaapidocs\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/docs\/10216","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/comments?post=10216"}],"version-history":[{"count":17,"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/docs\/10216\/revisions"}],"predecessor-version":[{"id":12470,"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/docs\/10216\/revisions\/12470"}],"wp:attachment":[{"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/media?parent=10216"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/doc_category?post=10216"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/doc_tag?post=10216"},{"taxonomy":"knowledge_base","embeddable":true,"href":"https:\/\/vita-xpro.com\/ar\/wp-json\/wp\/v2\/knowledge_base?post=10216"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}