1 files changed, 68 insertions, 0 deletions
diff --git a/src/server/api/endpoints/app/show.ts b/src/server/api/endpoints/app/show.ts
new file mode 100644
index 0000000000..99a2093b68
--- /dev/null
+++ b/src/server/api/endpoints/app/show.ts
@@ -0,0 +1,68 @@
+/**
+ * Module dependencies
+ */
+import $ from 'cafy';
+import App, { pack } from '../../../../models/app';
+
+/**
+ * @swagger
+ * /app/show:
+ *   note:
+ *     summary: Show an application's information
+ *     description: Require appId or nameId
+ *     parameters:
+ *       -
+ *         name: appId
+ *         description: Application ID
+ *         in: formData
+ *         type: string
+ *       -
+ *         name: nameId
+ *         description: Application unique name
+ *         in: formData
+ *         type: string
+ *
+ *     responses:
+ *       200:
+ *         description: Success
+ *         schema:
+ *           $ref: "#/definitions/Application"
+ *
+ *       default:
+ *         description: Failed
+ *         schema:
+ *           $ref: "#/definitions/Error"
+ */
+
+/**
+ * Show an app
+ */
+module.exports = (params, user, app) => new Promise(async (res, rej) => {
+	const isSecure = user != null && app == null;
+
+	// Get 'appId' parameter
+	const [appId, appIdErr] = $(params.appId).optional.id().$;
+	if (appIdErr) return rej('invalid appId param');
+
+	// Get 'nameId' parameter
+	const [nameId, nameIdErr] = $(params.nameId).optional.string().$;
+	if (nameIdErr) return rej('invalid nameId param');
+
+	if (appId === undefined && nameId === undefined) {
+		return rej('appId or nameId is required');
+	}
+
+	// Lookup app
+	const ap = appId !== undefined
+		? await App.findOne({ _id: appId })
+		: await App.findOne({ nameIdLower: nameId.toLowerCase() });
+
+	if (ap === null) {
+		return rej('app not found');
+	}
+
+	// Send response
+	res(await pack(ap, user, {
+		includeSecret: isSecure && ap.userId.equals(user._id)
+	}));
+});