{"id":20259719,"url":"https://github.com/sikkepitje/woots-powershell","last_synced_at":"2026-02-07T15:11:37.528Z","repository":{"id":41800073,"uuid":"510371247","full_name":"sikkepitje/Woots-PowerShell","owner":"sikkepitje","description":"PowerShell module wrapper for Woots API v2","archived":false,"fork":false,"pushed_at":"2024-09-13T07:26:15.000Z","size":60,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-29T18:52:17.424Z","etag":null,"topics":["api-wrapper","cbt","dutch-language","education","powershell","powershell-module","school-stuff","web","woots"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sikkepitje.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-07-04T13:30:39.000Z","updated_at":"2024-09-13T07:26:19.000Z","dependencies_parsed_at":"2024-09-13T17:18:46.396Z","dependency_job_id":"6ddeb034-068e-4189-aae7-1e4a056bbbcc","html_url":"https://github.com/sikkepitje/Woots-PowerShell","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/sikkepitje/Woots-PowerShell","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sikkepitje%2FWoots-PowerShell","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sikkepitje%2FWoots-PowerShell/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sikkepitje%2FWoots-PowerShell/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sikkepitje%2FWoots-PowerShell/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sikkepitje","download_url":"https://codeload.github.com/sikkepitje/Woots-PowerShell/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sikkepitje%2FWoots-PowerShell/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265485026,"owners_count":23774419,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api-wrapper","cbt","dutch-language","education","powershell","powershell-module","school-stuff","web","woots"],"created_at":"2024-11-14T11:16:10.943Z","updated_at":"2026-02-07T15:11:32.506Z","avatar_url":"https://github.com/sikkepitje.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"= Woots PowerShell\n\n== Abstract\n\nOp deze Github vind je een PowerShell module voor het interfacing met Woots Web API v2. Dit is gebaseerd op de https://app.woots.nl/api/docs/index.html#/[Woots API documentatie].\nOp dit moment zijn 185 API aanroepen als functie geimplementeerd. Daarvan zijn 2 nog niet geimplementeerd. \n\n== Vereisten\n\nWoots PowerShell module vereist PowerShell 5, PowerShell 7 of hoger.\n\n== Installatie\n\nDe module bestaat uit drie bestanden:  ``Woots.psm1``, ``Woots.psd1`` en  ``Woots-generatedcode.ps1``. \n\n. Bepaal de PowerShell modulemap waar je de Woots module wilt toevoegen. \n. Maak hierin een submap ``Woots``. \n. Download de bestanden ``Woots.psm1``, ``Woots.psd1`` en  ``Woots-generatedcode.ps1`` en plaats deze in een PowerShell modulemap. \n\n[NOTE]\n====\nEen modulemap voor Windows PowerShell tot en met versie 5.1 is bijvoorbeeld ``C:\\Users\\username\\Documents\\WindowsPowerShell\\Modules``. Raadpleeg de environment variabele ``$ENV:PSModulePath`` om te zien waar de modulemappen op jouw computer staan. \n====\n\n== Gebruik\n\nJe kunt de module in je scripts gebruiken door de module te importeren als volgt.\n\n[source,PowerShell]\n----\nImport-Module Woots\n----\n\nInitializeer Woots door een aanroep naar ``Initialize-Woots``. Deze functie verwacht 3 parameters:\n\n* ``$Hostname``  : \nDit is de hostname deel van de Woots API endpoint URL. In geval van https://app.woots.nl/api/v2,\ndan is dit het deel \"app.woots.nl\".\n* ``$School_id`` :\nDit is een unieke nummer voor de schoolomgeving in Woots. De school_id is zichtbaar in de Wootsportal\nonder Mijn account \u003e API-token.\n* ``$Token`` :\nDit is een hexadecimale string van 30 tekens waarmee toegang tot de Woots API wordt geauthoriseerd. \nJe kunt deze aanmaken in de Wootsportal  onder Mijn account \u003e API-token. \n\n\n== Documentatie \n\nWerp een blik op de functiedefinities in ``Woots-generatedCode.ps1`` om te zien welke functies er allemaal gedefinieerd zijn. \n\n=== Functieparameters\n\nAlle functies slechts één of meer van de volgende parameters. \n\n\n* ``$Id`` : het numeriek ID van de resource waarop de bewerking betrekking heeft (alle functies van de categorie Get-Resource, Get-ResourceItem, Set-Resource, Add-ResourceItem, Remove-Resource).\n\n* ``$Parameter`` : een hastable met de in te stellen attributen van een resource (alle functies van de categorie Add-Resource, Add-ResourceItem, Set-Resource, Set-ResourceItem), of een hashtable met naam-waarde-paren die het filter definieren voor een zoekactie (alle functies van de categorie Search-Resource).\n\n* ``$MaxItems`` : een getal , dat indien groter dan 0, het hoogste aantal items aangeeft, dat moeten worden opgehaald. Bij weglating van deze parameter of bij een negatieve waarde, wordt het maximum aantal beschikbare items geretourneerd (alle functies van de categorie Search-Resource, Get-AllResources).\n\nAlle parameters zijn PowerShell objecten, behalve waar het gaat om booleaanse waarden; in dat geval volstaat de string ``\"false\"`` of ``\"true\"``. \n\nVoorbeeld: \n\n----\n$filter = @{ \n    name = \"Aardrijkskunde\"\n    trashed = \"false\"\n}\n$result = Search-WootsCourse -Parameter $filter\n----\n\n=== Functieretourwaarden\nAlle functies retourneren wat er wordt opgehaald via de API aanvraag.\n\n== Extra's \n\nEen deel van de code in de module is gegenereerd door een codegenerator. \n\n* ``WootsModuleCodeGenerator.ps1`` : dit script genereert de code in ``Woots-generatedcode.ps1``. \n\n* ``Woots-api-calls.csv`` : dit bestand wordt ingelezen door ``WootsModuleCodeGenerator.ps1``. \n\n\n== Changes\n\n* 20230802 : added \"charset=utf-8\" to contenttype of Invoke-WebRequest to be able to send special chars in names and such.\n\n=== WootsModuleCodeGenerator.ps1\n\n* 20230815 Extract api calls automatically from  https://stage.woots.nl/api/docs/v2/swagger.yaml\n* 20230815 Added generation date and openapi version umber in generated code\n* 20230815 added API call for logs\n* 20230815 output code sorted and grouped by category \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsikkepitje%2Fwoots-powershell","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsikkepitje%2Fwoots-powershell","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsikkepitje%2Fwoots-powershell/lists"}