Five standard-library integration paths

Integration guides

Five proven paths from API key to first verified consent. Every example uses only standard-library HTTP — no SDK required. Base URL https://api.ethiolink-consent.et (sandbox: http://localhost:4100).

Node.js

fetch-based, async, zero deps — matches our mini-SDK.

Python

urllib / requests examples for consent + verification.

PHP

cURL-based flow for classic LAMP stacks.

Java

HttpClient (Java 11+) for enterprise integrations.

Flutter / Dart

Dart http package — mobile banking & wallet apps.

The flow in one diagram

  Your system                     User (EthioLink dashboard / SMS)
  -----------                     ---------------------------------
  1. POST /api/consent/request ──► sees "who wants what, why, how long"
                                    approves (or rejects / objects)
  2. GET /api/consent/active ◄──── consent token (JWT) issued
     ?token=&reason=loan_application
  3. GET /api/data/retrieve ◄──── retrieve only the granted consumer's data
  4. POST /api/consent/revoke ◄── user revokes; every check fails instantly

Requests involving automated decision-making must include involves_automation + automation_description, and the user must acknowledge before approval — see the API reference.