README

待办事项

• 实现单元测试。
• 包文档。

安装

添加到 composer

composer require germanazo/laravel-ckan-api

加载服务提供者

在 config/app.php 中注册服务提供者

    'provider' => [
        ...
        Germanazo\CkanApi\CkanServiceProvider::class,
        ...
    ]

并在同一配置文件中注册外观别名。

    'aliases' => [
        ...
        'CkanApi' => Germanazo\CkanApi\Facades\CkanApi::class,
        ...
    ]

发布供应商

php artisan vendor:publish --provider="Germanazo\CkanApi\CkanServiceProvider"

配置 Ckan API

配置位于 config/ckan_api.php 的文件，或者如果您喜欢，可以使用环境变量

CKAN_API_URL=https://data.myckan.com
CKAN_API_KEY={{MY SUPER SECRET API KEY}

如果您知道自己在做什么，那么也可以配置 API 版本

CKAN_API_VERSION=2

CKAN_API_KEY 可在您的 ckan 用户资料中找到。

使用它

use CkanApi

// Get paginated results
CkanApi::dataset()->all(['start' => $start]); // Start variable works only for datasets for now

// Second argument is to define extra params from *_show
CkanApi::dataset()->show('ref-id', ['include_tracking' => true]);
CkanApi::dataset()->create(['owner_org' => 'my-org', 'name' => 'super-title','title' => 'SUPER API TITLE']);
CkanApi::dataset()->update(['id' => 'ref-id', ...]);
CkanApi::dataset()->delete('ref-id');

//Only for dataset 
CkanApi::dataset()->revision_list('ref-id');

创建包中资源的示例

$data = [
    'url' => 'https://recursos-data.buenosaires.gob.ar/ckan2/distritos-escolares/distritos-escolares.csv',
    'clear_upload' => true,
    'package_id' => 'ckan-api-test-338',
    'name' => 'Buenos Aires - Distritos Escolares',
    'format' => 'CSV',
    'description' => 'Límites y ubicación geográfica de los distritos escolares de la Ciudad que surgieron a partir de la Ley de Educación Común (Ley N° 1.420/1884). Actualmente rige la división establecida por el Decreto Nº 7.475/80.',
];

CkanApi::resource()->create($data);

上传文件创建资源的示例

$data = [
    'upload' => fopen(storage_path('app/catalogo-bibliotecas.csv'), 'r'),
//  'mimetype' => 'text/csv',
    'package_id' => 'ckan-api-test-338',
    'name' => 'Buenos Aires - Bibliotecas',
    'format' => 'CSV',
    'description' => 'Listado con ubicación geográfica de las bibliotecas de la Red del gobierno de la Ciudad Autónoma de Buenos Aires.',
];

CkanApi::resource()->create($data);

所有可能的资源

CkanApi::dataset()
CkanApi::resource()
CkanApi::group()
CkanApi::tag()
CkanApi::revision()
CkanApi::license()
CkanApi::organization()
CkanApi::user()

所有资源都启用了以下方法： all, show, create, update, delete，但某些端点只启用了其中的一些方法。

更多示例请参阅 docs/simple_routing.md

更多信息请参阅 http://docs.ckan.org/en/latest/api/