Extension API Docs


Extension Basics

Title
API Docs
Name
ckanext-apidocs
Type
Public extension
Description
Documents CKAN APIs for developers with OpenAPI/Swagger UI interface.
CKAN versions

~2.10

Show details
Download-Url (zip)
Last commit
a year ago (2024-09-16 22:07:20)
Url to repo
Category
Content Management


Background Infos

Description (long)
Show details

ckanext-apidocs

This extension documents CKAN APIs for developers who want to write code that interacts with CKAN site and its data. CKAN’s Action API is a powerful, RPC-style API that exposes all of CKAN’s core features to API clients.

This plugin provides the option of using the OpenAPI and is developed on top of the Swagger UI.

Swagger UI allows anyone — be it your development team or your end consumers — to visualize and interact with the API’s resources without having any of the implementation logic in place.

Requirements

CKAN Version Compatible
2.9 not tested
2.10 tested

Installation

  1. Activate your CKAN virtual environment:

    . /usr/lib/ckan/default/bin/activate
    
  2. Clone the source and install:

    git clone https://github.com/agmorev/ckanext-apidocs.git
    cd ckanext-apidocs
    pip install -e .
    pip install -r requirements.txt
    
  3. Add apidocs to the ckan.plugins setting.

  4. Add link apidocs to the appropriate place on the site:

    <a href="{{ h.url_for('apidocs.index') }}">{{ _('CKAN API') }}</a>
    
  5. apidocs page is available on the URL https://<hostname>/api/docs/

Config Settings

The content of the API actions can be changed or added by making changes to the file swagger.json placed in /public folder.

Version
0.0.1
Version release date
2023-01-01
Contact name
Aleksey Morev
Contakt email
(not set)
Contact Url


Installation Guide

Configuration hints

Die API-Aktionen können über eine swagger.json Datei im /public Ordner angepasst werden.

Plugins to configure (ckan.ini)
apidocs
CKAN Settings (ckan.ini)
DB migration to be executed
(not set)
<< back to Extensions