{"id":16993352,"url":"https://github.com/ioggstream/python-api-test","last_synced_at":"2026-04-13T17:04:33.961Z","repository":{"id":142040432,"uuid":"289022913","full_name":"ioggstream/python-api-test","owner":"ioggstream","description":"A simple python API for a TDD Course","archived":false,"fork":false,"pushed_at":"2020-09-28T21:41:15.000Z","size":75,"stargazers_count":0,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-27T06:12:49.726Z","etag":null,"topics":["openapi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ioggstream.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2020-08-20T14:08:19.000Z","updated_at":"2020-09-28T21:41:17.000Z","dependencies_parsed_at":null,"dependency_job_id":"aecf4b48-7778-42b9-b189-c05ff11181fb","html_url":"https://github.com/ioggstream/python-api-test","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":"teamdigitale/api-starter-kit-python","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ioggstream%2Fpython-api-test","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ioggstream%2Fpython-api-test/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ioggstream%2Fpython-api-test/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ioggstream%2Fpython-api-test/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ioggstream","download_url":"https://codeload.github.com/ioggstream/python-api-test/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244909427,"owners_count":20530231,"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":["openapi"],"created_at":"2024-10-14T03:42:56.675Z","updated_at":"2026-04-13T17:04:33.925Z","avatar_url":"https://github.com/ioggstream.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Starter kit per la pubblicazione di API interoperabili in Python\n\n[![CircleCI](https://circleci.com/gh/teamdigitale/api-starter-kit-python.svg?style=svg)](https://circleci.com/gh/teamdigitale/api-starter-kit-python)\n[![Join the #api channel](https://img.shields.io/badge/Slack-%23api-blue.svg?logo=slack)](https://developersitalia.slack.com/messages/CDKBYTG74)\n[![Get invited](https://slack.developers.italia.it/badge.svg)](https://slack.developers.italia.it/)\n[![API on forum.italia.it](https://img.shields.io/badge/Forum-interoperabilità-blue.svg)](https://forum.italia.it/c/interoperabilita)\n\nQuesto repository contiene il template di un'API interoperabile scritta in Python.\n\n## Contenuto\n\n- Un progetto di esempio con python e connexion senza la generazione di codice\n- Una directory `openapi` con le specifiche\n\n## Istruzioni\n\nGli step per la creazione di API interoperabili sono:\n\n1. scrivere le specifiche in formato OpenAPI v3 partendo dagli esempi in `openapi`;\n\n2. scrivere i metodi dell'applicazione\n\n### Scrivere le specifiche\n\nLe specifiche devono essere scritte in formato OpenAPIv3\ne rispettando le [Linee Guida di interoperabilità](https://docs.italia.it/italia/piano-triennale-ict/lg-modellointeroperabilita-docs).\n\nQueste presentazioni possono essere d'aiuto:\n\n- [Introduzione ad OpenAPI](https://docs.google.com/presentation/d/1blql0E_zcbq7r-wzmslgJPiW7ELkYlIn9_fqIVEXr4A)\n- [REST nel nuovo modello di interoperabilità](https://docs.google.com/presentation/u/1/d/1L6R4ZKhLoZAPEmai1KSED1nrq0GNrx3-TU53sGhfrO8/)\n\n### Risolvere le dipendenze negli OpenAPI\n\nLe specifiche OpenAPI possono contenere riferimenti a schemi esterni\no [yaml anchors](). E' possibile risolverli tramite il modulo python\n`openapi_resolver`, richamato dal `Makefile`.\n\nIn questo repository, i file con anchor e ref hanno estensione `.yaml.src`\nma sono a tutti gli effetti file OAS3 validi e la maggior parte dei\ntool li interpreta correttamente. E' comunque possibile dereferenziarli\nper comodità tramite il comando:\n\n\tmake yaml\n\n\n### Dipendenze\n\nPer eseguire questa app servono:\n\n```\nmake\npython 3 + tox\ndocker\n```\n\n\n### Test con docker\n\nQuesto comando lancia tutti i container necessari ed esegue i test:\n\n```\ndocker-compose up test\n```\n\n### Test con circleci\n\nE' possibile testare in locale tramite circleci, con:\n\n        circleci build\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fioggstream%2Fpython-api-test","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fioggstream%2Fpython-api-test","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fioggstream%2Fpython-api-test/lists"}