{"id":36734565,"url":"https://github.com/lambda-feedback/evaluation-function-api","last_synced_at":"2026-01-12T12:18:26.928Z","repository":{"id":244530574,"uuid":"815471094","full_name":"lambda-feedback/evaluation-function-api","owner":"lambda-feedback","description":"OpenAPI Specification and Validation Schemas for the Evaluation Function API","archived":false,"fork":false,"pushed_at":"2024-06-15T12:40:04.000Z","size":24,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-09-05T03:50:07.494Z","etag":null,"topics":["evaluation-function-api","openapi","swagger"],"latest_commit_sha":null,"homepage":"https://lambda-feedback.github.io/evaluation-function-api/","language":null,"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/lambda-feedback.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-06-15T08:58:26.000Z","updated_at":"2024-06-15T12:40:06.000Z","dependencies_parsed_at":"2024-06-15T12:42:44.624Z","dependency_job_id":null,"html_url":"https://github.com/lambda-feedback/evaluation-function-api","commit_stats":null,"previous_names":["lambda-feedback/evaluation-function-api"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lambda-feedback/evaluation-function-api","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambda-feedback%2Fevaluation-function-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambda-feedback%2Fevaluation-function-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambda-feedback%2Fevaluation-function-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambda-feedback%2Fevaluation-function-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lambda-feedback","download_url":"https://codeload.github.com/lambda-feedback/evaluation-function-api/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lambda-feedback%2Fevaluation-function-api/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28338975,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-12T10:58:46.209Z","status":"ssl_error","status_checked_at":"2026-01-12T10:58:42.742Z","response_time":98,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["evaluation-function-api","openapi","swagger"],"created_at":"2026-01-12T12:18:26.824Z","updated_at":"2026-01-12T12:18:26.915Z","avatar_url":"https://github.com/lambda-feedback.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Evaluation Function API\n\n\u003cdiv style=\"text-align:center\" align=\"center\"\u003e\n\u003cimg src=\"https://github.com/lambda-feedback/evaluation-function-api/actions/workflows/openapi_docs.yml/badge.svg?branch=main\" /\u003e\n\u003ca href=\"https://lambda-feedback.github.io/evaluation-function-api/\"\u003e\n\u003cimg src=\"https://img.shields.io/badge/Docs-OpenAPI-blue?logo=github\u0026labelColor=24292E\"/\u003e\n\u003c/a\u003e\n\u003c/div\u003e\n\nThis repository contains the specification and validation schemas for the Lambda Feedback Evaluation Function API. The API is expected to be implemented by evaluation functions that are used in the Lambda Feedback platform.\n\n## Overview\n\nThe Evaluation Function API provides a comprehensive solution for educational assessment systems, using an RPC-like approach via HTTP with commands specified in request headers. It enables automated grading and validation of student responses against educator-defined answers, with support for custom evaluation parameters and real-time preview functionality.\n\n## Core Features\n\n### Evaluation (`eval` command)\nThe primary endpoint for grading student responses. It compares a student's submission against the correct answer and returns:\n- Boolean correctness indicator (`is_correct`)\n- Optional feedback (string, array, or object format)\n- Support for custom evaluation parameters (e.g., case sensitivity, tolerance levels)\n\n### Preview (`preview` command)\nA lightweight validation endpoint that normalizes and validates student responses without performing full evaluation. Useful for:\n- Real-time input validation as students type\n- Formatting and normalization checks\n- Pre-submission validation\n\nReturns a normalized version of the student's response.\n\n### Health Check (`healthcheck` command)\nMonitors the operational status of the evaluation function by running internal tests. Returns detailed diagnostics including:\n- Overall test status (`tests_passed`)\n- Lists of successful tests, failures, and errors\n- Useful for monitoring and debugging evaluation functions\n\n## Command Header\n\nThe `command` header specifies the action to be performed by the evaluation function. The API currently supports three commands:\n- `eval` - Evaluate student responses against correct answers\n- `preview` - Validate and normalize responses without evaluation\n- `healthcheck` - Verify operational status of the evaluation function\n\n## Documentation\n\nThe full OpenAPI documentation is available [here](https://lambda-feedback.github.io/evaluation-function-api/).\n\n## Repository Structure\n\nThis repository contains:\n- OpenAPI specification (YAML format)\n- JSON Schema validation files for:\n  - Evaluation requests (`request-eval.json`)\n  - Preview requests (`request-preview.json`)\n  - Evaluation responses (`response-eval.json`)\n  - Preview responses (`response-preview.json`)\n  - Health check responses (`response-health.json`)\n\n## Contributing\n\nContributions to improve the API specification or documentation are welcome. Please ensure all changes maintain backward compatibility and update both the OpenAPI spec and JSON schemas accordingly.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flambda-feedback%2Fevaluation-function-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flambda-feedback%2Fevaluation-function-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flambda-feedback%2Fevaluation-function-api/lists"}