README

Introduction

Use the Numeno Administration API to create API Keys and set their permissions (which we call Scopes). This API is meant to be used by administrators of your organization.

Scopes

Scopes are used to let API Keys access only certain parts of the API.

Scopes are expressed as a string of the form api:resource:action.

For example, from the Numeno Article Recommender API (art-rec):

• art-rec:feeds:read - can read any Feed (eg. GET /feeds, /feeds/:id, /feeds/:id/streams, etc.)
• art-rec:feeds:write - can write (and read) any Feed
• art-rec:feeds:* - can perform any action on Feeds
• art-rec:*:read - can read any resource on art-rec
• *:*:* - can do everything

For more information, please visit https://numeno.ai/.

Installation & Usage

Requirements

PHP 7.4 and later.

Composer

To install the bindings via Composer, add the following to composer.json:

{
  "minimum-stability": "dev",
  "require": {
    "numeno/api-admin": "dev-main"
  }
}

Then run composer install

Getting Started

Please follow the installation procedure and then run the following:

<?php
require_once(__DIR__ . '/vendor/autoload.php');



// Configure API key authorization: ApiKeyAuth
$config = NumenoAdmin\Configuration::getDefaultConfiguration()->setApiKey('X-Numeno-Key', 'YOUR_API_KEY');
// Uncomment below to setup prefix (e.g. Bearer) for API key, if needed
// $config = NumenoAdmin\Configuration::getDefaultConfiguration()->setApiKeyPrefix('X-Numeno-Key', 'Bearer');


$apiInstance = new NumenoAdmin\Api\DefaultApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client(),
    $config
);
$key_new = new \NumenoAdmin\Model\KeyNew(); // \NumenoAdmin\Model\KeyNew

try {
    $result = $apiInstance->createKey($key_new);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling DefaultApi->createKey: ', $e->getMessage(), PHP_EOL;
}

API Endpoints

All URIs are relative to https://api.numeno.ai/admin

Models

• ErrorDetail
• ErrorResponse
• HealthCheck
• KeyInfo
• KeyInfoFull
• KeyInfoList
• KeyNew
• KeyUpdate
• Scopes

Authorization

Authentication schemes defined for the API:

ApiKeyAuth

• Type: API key
• API key parameter name: X-Numeno-Key
• Location: HTTP header

Author

support@numeno.ai

About this package

This PHP package is automatically generated by the OpenAPI Generator project:

• API version: 1.0.0
  • Package version: 0.0.5
  • Generator version: 7.10.0
• Build package: org.openapitools.codegen.languages.PhpClientCodegen