The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Apigee::Edge - Apigee.com 'Edge' management API.

SYNOPSIS

use Apigee::Edge;

my $apigee = Apigee::Edge->new(
  org => 'apigee_org',
  usr => 'your_email',
  pwd => 'your_password'
);

DESCRIPTION

Apigee::Edge is an object-oriented interface to facilitate management of Developers and Apps using the Apigee.com 'Edge' management API. see http://apigee.com/docs/api-services/content/api-reference-getting-started

The API is incompleted. welcome to fork the repos on github https://github.com/binary-com/perl-Apigee-Edge and send us pull-requests.

METHODS

new

  • org

    required. organization name.

  • usr

    required. login email

  • pwd

    required. login password

  • endpoint

    optional. default to https://api.enterprise.apigee.com/v1

Apps

http://apigee.com/docs/api/apps-0

get_app

my $app = $apigee->get_app($app_id);

get_apps

my $app_ids = $apigee->get_apps();
my $apps = $apigee->get_apps(expand => 'true', includeCred => 'true');

get_apps_by_family

my $app_ids = $apigee->get_apps_by_family($family);

get_apps_by_keystatus

my $app_ids = $apigee->get_apps_by_keystatus($keystatus);

get_apps_by_type

my $app_ids = $apigee->get_apps_by_type($type);

Developers

http://apigee.com/docs/api/developers-0

get_developers

my $developers = $apigee->get_developers();

get_app_developers

my $developers = $apigee->get_app_developers($app_name);

get_developer

my $developer = $apigee->get_developer('fayland@binary.com') or die $apigee->errstr;

create_developer

my $developer = $apigee->create_developer(
    "email" => 'fayland@binary.com',
    "firstName" => "Fayland",
    "lastName" => "Lam",
    "userName" => "fayland.binary",
    "attributes" => [
        {
            "name" => "Attr1",
            "value" => "V1"
        },
        {
            "name" => "A2",
            "value" => "V2.v2"
        }
    ]
);

update_developer

my $developer = $apigee->update_developer(
    $developer_email,
    {
        "firstName" => "Fayland",
        "lastName" => "Lam",
    }
);

delete_developer

my $developer = $apigee->delete_developer('fayland@binary.com') or die $apigee->errstr;

set_developer_status

my $status = $apigee->set_developer_status($email, $status);

Apps: Developer

http://apigee.com/docs/api/apps-developer

change_app_status

my $app = $apigee->change_app_status($developer_email, $app_name);

create_developer_app

my $app = $apigee->create_developer_app(
    $developer_email,
    {
        "name" => "Test App",
        "apiProducts" => [ "{apiproduct1}", "{apiproduct2}", ...],
        "keyExpiresIn" => "{milliseconds}",
        "attributes" => [
            {
                "name" => "DisplayName",
                "value" => "{display_name_value}"
            },
            {
                "name" => "Notes",
                "value" => "{notes_for_developer_app}"
            },
            {
                "name" => "{custom_attribute_name}",
                "value" => "{custom_attribute_value}"
            }
        ],
        "callbackUrl" => "{url}",
    }
);

delete_developer_app

my $app = $apigee->delete_developer_app($developer_email, $app_name);

get_developer_app

my $app = $apigee->get_developer_app($developer_email, $app_name);

get_developer_apps

my $apps = $apigee->get_developer_apps($developer_email);
my $apps = $apigee->get_developer_apps($developer_email, { expand => 'true' });

update_developer_app

my $app = $apigee->update_developer_app($developer_email, $app_name, {
    # update part
});

regenerate_developer_app_key

my $app = $apigee->regenerate_developer_app_key($developer_email, $app_name, {
    # update part
});

get_count_of_developer_app_resource

my $count = $apigee->get_count_of_developer_app_resource($developer_email, $app_name, $entity_name);

API Products

http://apigee.com/docs/api/api-products-1

get_api_products

my $products = $apigee->get_api_products();
my $products = $apigee->get_api_products(expand => 'true');

search_api_products

my $products = $apigee->search_api_products('attributename' => 'access', 'attributevalue' => 'public');
my $products = $apigee->search_api_products('attributename' => 'access', 'attributevalue' => 'private', expand => 'true');

get_api_product

my $product = $apigee->get_api_product($product_name);

get_api_product_details

my $apps = $apigee->get_api_product_details(
    $product_name,
    query => 'list', entity => 'apps' # or query => 'count', entity => 'keys, apps, developers, or companies'
);

delete_api_product

my $product = $apigee->delete_api_product($product_name);

create_api_product

my $product = $apigee->create_api_product(
    "approvalType" => "manual",
    "attributes" => [
        {
          "name" => "access",
          "value" => "private"
        },
        {
          "name" => "ATTR2",
          "value" => "V2"
        }
    ],
    "description" => "DESC",
    "displayName" => "TEST PRODUCT NAME",
    "name"  => "test-product-name",
    "apiResources" => [ "/resource1", "/resource2"],
    "environments" => [ "test", "prod"],
    # "proxies" => ["{proxy1}", "{proxy2}", ...],
    # "quota" => "{quota}",
    # "quotaInterval" => "{quota_interval}",
    # "quotaTimeUnit" => "{quota_unit}",
    "scopes" => ["user", "repos"]
);

update_api_product

my $product = $apigee->update_api_product(
    "test-product-name",
    {
        "approvalType" => "auto",
        "displayName" => "ANOTHER TEST PRODUCT NAME",
    }
);

request

The underlaying method to call Apigee when you see something is missing.

$self->request('GET', "/o/$org_name/apps/$app_id");
$self->request('DELETE', "/o/$org_name/developers/" . uri_escape($email));
$self->request('POST', "/o/$org_name/developers", %args);
$self->request('PUT', "/o/$org_name/developers/" . uri_escape($email), %args);

errstr

GITHUB

https://github.com/binary-com/perl-Apigee-Edge

AUTHOR

Binary.com <fayland@binary.com>

COPYRIGHT

Copyright 2014- Binary.com

SEE ALSO