--- keys.api.php (saved version)
+++ (current document)
@@ -0,0 +1,35 @@
+<?php
+// $Id$
+
+/**
+ * @file
+ * Hooks provided by Keys module.
+ *
+ * @author greenSkin
+ */
+
+/**
+ * Inform Keys of a service type.
+ *
+ * This hook is for implementation by keys service modules. In this hook, the
+ * module defines a service type to the keys module. A service can be defined
+ * as the service a key would be used for. For instance Google Maps is a
+ * service that keys can be assigned to.
+ *
+ * Modules should only have to implement this hook when exposing a new service
+ * that another module has not already implemented.
+ *
+ * @return
+ *   An array whose keys are a machine readable identifier of the service, and
+ *   whose values are arrays containing the following items:
+ *   - name: The human readable name of the service.
+ *   - description: A brief description of what the service is for.
+ */
+function hook_keys_service() {
+  return array(
+    'example' => array(
+      'name' => t('Example'),
+      'description' => t('Example API Key')
+    ),
+  );
+}