Dokumentasi API SekolahKu

API RESTful untuk integrasi dan pengelolaan sistem sekolah. Standar OAuth2, response JSON.

Base URL: https://sekolahku.sains.dev/api/v1

Overview

API SekolahKu menggunakan OAuth2 untuk autentikasi. Semua request ke endpoint yang terproteksi harus menyertakan access token di header Authorization.

OAuth2 Grant Types

API ini mendukung 3 grant type OAuth2:

Client Credentials — untuk server-to-server integration (paling umum)
Password — untuk login via username/password (deprecated untuk third-party)
Authorization Code — untuk OAuth2 web flow
Refresh Token — untuk perpanjangan access token

Quick Start

bash — 3 Langkah

# 1. Daftar sekolah di panel SekolahKu
# 2. Dapatkan client_id & client_secret
# 3. Tukar dengan access token

curl -X POST https://sekolahku.sains.dev/api/v1/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

🧪 Try It — Client Credentials Grant

client_id client_secret grant_type

Token Endpoint

POST

/oauth/token

Dapatkan Access Token

▶

Menukar kredensial klien dengan access token OAuth2. Mendukung client_credentials, password, dan authorization_code grant types.

Request Body (client_credentials)

Field	Type	Required	Description
grant_type	string	required	Tipe grant: `client_credentials`, `password`, `authorization_code`
client_id	string	required	Client ID yang diberikan saat registrasi
client_secret	string	required	Client Secret yang diberikan saat registrasi
scope	string	optional	Scope yang diminta (default: semua)

Request Body (password)

Field	Type	Required	Description
grant_type	string	required	`password`
username	string	required	Email user
password	string	required	Password user
client_id	string	required	Client ID
client_secret	string	required	Client Secret

Response

200 OK — JSON

{
  "access_token": "eyJ0eXAiOiJKV1...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "dGhpcyBpcyBhIHJlZnJlc2g...",
  "scope": "*"
}

🧪 Try It

client_id client_secret grant_type

Refresh Token

POST

/oauth/token/refresh

Perpanjang Access Token

▶

Gunakan refresh token untuk mendapatkan access token baru tanpa login ulang.

Field	Type	Required	Description
refresh_token	string	required	Refresh token dari response token sebelumnya

🧪 Try It

refresh_token

Revoke Token

POST

/oauth/revoke

Cabut Access Token

▶

Cabut access token atau refresh token sebelum expired.

Field	Type	Required	Description
token	string	required	Token yang akan dicabut

Get Current Token Info

GET

/me

Info User & Token

▶

Dapatkan informasi user dan scope yang terkait dengan access token saat ini.

Authorization: Bearer {token}

curl -X GET https://sekolahku.sains.dev/api/v1/me \
  -H "Authorization: Bearer {access_token}"