flagrow/flarum-api-client

Standalone package for calling the API of a Flarum installation.

flarum-api-client by flagrow

, _(*1)

This is a generic PHP API client for use in any project. You can simply include this package as a dependency to your project to use it., _(*2)

installation

composer require flagrow/flarum-api-client

configuration

In order to start working with the client you might need a Flarum master key:, _(*3)

1. Generate a 40 character random, unguessable string, this is the Token needed for this package.
2. Manually add it to the api_keys table using phpmyadmin/adminer or another solution.

The master key is required to access non-public discussions and running actions otherwise reserved for Flarum administrators., _(*4)

examples

A basic example:, _(*5)

<?php

require_once "vendor/autoload.php";

use Flagrow\Flarum\Api\Flarum;

$api = new Flarum('http://example.com');

// A collection of discussions from the first page of your Forum index.
$discussions = $api->discussions()->request();
// Read a specific discussion.
$discussion = $api->discussions()->id(1)->request();
// Read the first page of users.
$users = $api->users()->request();

An authorized example:, _(*6)

$api = Flarum('http://example.com', ['token' => '<insert-master-token>; userId=1']);

The userId refers to a user that has admin permissions or the user you want to run actions for. Appending the userId setting to the token only works for Master keys., _(*7)

links

• on github
• on packagist
• issues
• changelog

Flagrow is a collaboration of Flarum extension developers to provide quality, maintained extensions., _(*8)