Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Variable Name

Description

Example Content

apiUser

This is the username of the user you wish to use the API with.
This username can be any user login in your system.

YourApplicationName.API

apiPw

The password for the user

*********

host

The hostname of your site

https://abc.edu.net.au

Logging In

You will need to set the HTTP Authorization header as “Basic {{encodedPassString}}”

The encoded pass string is your username:password encoded in base64.

Note

Do not use online tools to generate your base64 encoded logins. This introduces a HEAVY security risk in sharing with not only the site, but any other software on your system that might intercept the header.

On Windows you can do this in PowerShell:

Code Block
languagepowershell
powershell "[convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes(\"username:password\"))"

Just replace username and password with the values you want to set.

If you are using Linux :

Code Block
languagebash
echo  'username:password' | base64

Example Requests

In the top menu you have the option to select the LANGUAGE - as in the programming language or method that you will be using to connect to the API.

By default this is curl:

Code Block
languagebash
curl --location -g --request GET 'https://host/api/rest/EduNoteData/?partyId={{sampleStudentPartyId}}' \
--header 'Content-Type: application/json'

...