# README

Go API client for iam

API for managing and authenticating Netsoc users.

Overview

This API client was generated by the OpenAPI Generator project. By using the OpenAPI-spec from a remote server, you can easily generate an API client.

API version: 1.0.11
Package version: 1.0.0
Build package: org.openapitools.codegen.languages.GoClientCodegen

Installation

Install the following dependencies:

go get github.com/stretchr/testify/assert
go get golang.org/x/oauth2
go get golang.org/x/net/context
go get github.com/antihax/optional

Put the package under your project folder and add the following in import:

import "./iam"

Documentation for API Endpoints

All URIs are relative to https://iam.netsoc.ie/v1

Class	Method	HTTP request	Description
UsersApi	CreateUser	Post /users	Create a new user
UsersApi	DeleteUser	Delete /users/{username}	Delete a user by their username
UsersApi	GetUser	Get /users/{username}	Get a user by their username
UsersApi	GetUserByID	Get /users/id:{uid}	Get a user by their ID
UsersApi	GetUsers	Get /users	List users
UsersApi	IssueToken	Post /users/{username}/token	Issue a token
UsersApi	Login	Post /users/{username}/login	Log into a user account (obtain JWT)
UsersApi	Logout	Delete /users/{username}/login	Log out of a user account (invalidate existing JWT's)
UsersApi	ResetPassword	Put /users/{username}/login	Reset password
UsersApi	UpdateUser	Patch /users/{username}	Update a user by their username
UsersApi	ValidateToken	Get /users/self/token	Validate a token
UsersApi	Verify	Patch /users/{username}/login	Verify email address

Documentation For Models

Documentation For Authorization

jwt

Type: HTTP basic authentication

Example

auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
    UserName: "username",
    Password: "password",
})
r, err := client.Service.Operation(auth, args)

jwt_admin

Type: HTTP basic authentication

Example

auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
    UserName: "username",
    Password: "password",
})
r, err := client.Service.Operation(auth, args)

jwt_reset

Type: HTTP basic authentication

Example

auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
    UserName: "username",
    Password: "password",
})
r, err := client.Service.Operation(auth, args)

jwt_verify

Type: HTTP basic authentication

Example

auth := context.WithValue(context.Background(), sw.ContextBasicAuth, sw.BasicAuth{
    UserName: "username",
    Password: "password",
})
r, err := client.Service.Operation(auth, args)