{"components":{"responses":{},"schemas":{"Author":{"nullable":true,"properties":{"avatar_url":{"nullable":true,"type":"string"},"username":{"type":"string"}},"title":"Author","type":"object"},"Categoria":{"properties":{"canonical_url":{"type":"string"},"color":{"type":"string"},"icon":{"nullable":true,"type":"string"},"id":{"type":"integer"},"name":{"type":"string"},"project_count":{"type":"integer"},"slug":{"type":"string"}},"title":"Categoria","type":"object"},"CategoriaListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Categoria"},"type":"array"}},"title":"CategoriaListResponse","type":"object"},"Category":{"properties":{"id":{"type":"integer"},"name":{"type":"string"},"slug":{"type":"string"}},"title":"Category","type":"object"},"Contributor":{"properties":{"email":{"nullable":true,"type":"string"},"name":{"type":"string"},"url":{"nullable":true,"type":"string"}},"title":"Contributor","type":"object"},"Error":{"properties":{"error":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}},"title":"Error","type":"object"},"EventoListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Projeto"},"type":"array"},"meta":{"properties":{"total":{"type":"integer"}},"type":"object"}},"title":"EventoListResponse","type":"object"},"MeResponse":{"description":"Identifies the user and scope behind the calling API key (issue #140).","properties":{"data":{"properties":{"scope":{"enum":["read","read_write"],"type":"string"},"user":{"properties":{"id":{"type":"integer"},"role":{"type":"string"},"username":{"type":"string"}},"type":"object"}},"type":"object"}},"title":"MeResponse","type":"object"},"Project":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/Category"},"type":"array"},"cfp_end_date":{"format":"date","nullable":true,"type":"string"},"cfp_open":{"type":"boolean"},"cfp_start_date":{"format":"date","nullable":true,"type":"string"},"cfp_url":{"nullable":true,"type":"string"},"event_end_date":{"format":"date-time","nullable":true,"type":"string"},"event_location":{"nullable":true,"type":"string"},"event_start_date":{"format":"date-time","nullable":true,"type":"string"},"event_type":{"enum":["presencial","online","hibrido"],"nullable":true,"type":"string"},"full_description":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"format":"date-time","type":"string"},"main_image_path":{"nullable":true,"type":"string"},"not_owner":{"type":"boolean"},"short_description":{"type":"string"},"slug":{"nullable":true,"type":"string"},"source":{"enum":["web","api","cli"],"type":"string"},"status":{"enum":["draft","pending_review","approved","rejected"],"type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"updated_at":{"format":"date-time","type":"string"},"url":{"nullable":true,"type":"string"},"user_id":{"type":"integer"}},"title":"Project","type":"object"},"ProjectListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Project"},"type":"array"},"meta":{"properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}},"type":"object"}},"title":"ProjectListResponse","type":"object"},"ProjectRequest":{"properties":{"project":{"$ref":"#/components/schemas/ProjectWritable"}},"required":["project"],"title":"ProjectRequest","type":"object"},"ProjectResponse":{"properties":{"data":{"$ref":"#/components/schemas/Project"}},"title":"ProjectResponse","type":"object"},"ProjectWritable":{"description":"Fields the caller may write. Unknown keys are ignored.","properties":{"category_ids":{"items":{"type":"integer"},"type":"array"},"cfp_end_date":{"format":"date","type":"string"},"cfp_open":{"type":"boolean"},"cfp_start_date":{"format":"date","type":"string"},"cfp_url":{"type":"string"},"event_end_date":{"format":"date-time","type":"string"},"event_location":{"type":"string"},"event_start_date":{"format":"date-time","type":"string"},"event_type":{"enum":["presencial","online","hibrido"],"type":"string"},"full_description":{"type":"string"},"not_owner":{"type":"boolean"},"short_description":{"maxLength":200,"type":"string"},"slug":{"type":"string"},"tags_string":{"description":"Comma-separated tags","type":"string"},"title":{"maxLength":200,"minLength":3,"type":"string"},"url":{"type":"string"}},"title":"ProjectWritable","type":"object"},"Projeto":{"description":"Public, read-only representation of an approved project (issue #141).","properties":{"author":{"$ref":"#/components/schemas/Author"},"canonical_url":{"type":"string"},"categories":{"items":{"$ref":"#/components/schemas/Category"},"type":"array"},"cfp_end_date":{"format":"date","nullable":true,"type":"string"},"cfp_open":{"type":"boolean"},"cfp_start_date":{"format":"date","nullable":true,"type":"string"},"cfp_url":{"nullable":true,"type":"string"},"contributors":{"items":{"$ref":"#/components/schemas/Contributor"},"type":"array"},"event_end_date":{"format":"date-time","nullable":true,"type":"string"},"event_location":{"nullable":true,"type":"string"},"event_start_date":{"format":"date-time","nullable":true,"type":"string"},"event_type":{"enum":["presencial","online","hibrido"],"nullable":true,"type":"string"},"full_description":{"nullable":true,"type":"string"},"id":{"type":"integer"},"inserted_at":{"format":"date-time","type":"string"},"main_image_path":{"nullable":true,"type":"string"},"short_description":{"type":"string"},"slug":{"description":"URL slug, e.g. \"minha-api-42\".","type":"string"},"tags":{"items":{"type":"string"},"type":"array"},"title":{"type":"string"},"updated_at":{"format":"date-time","type":"string"},"url":{"nullable":true,"type":"string"}},"title":"Projeto","type":"object"},"ProjetoListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/Projeto"},"type":"array"},"meta":{"properties":{"page":{"type":"integer"},"per_page":{"type":"integer"},"total":{"type":"integer"},"total_pages":{"type":"integer"}},"type":"object"}},"title":"ProjetoListResponse","type":"object"},"ProjetoResponse":{"properties":{"data":{"$ref":"#/components/schemas/Projeto"}},"title":"ProjetoResponse","type":"object"}},"securitySchemes":{"bearer":{"description":"API key issued at /users/api-keys.","scheme":"bearer","type":"http"}}},"info":{"description":"REST API for the DevSnorte community platform.\n\nAll endpoints require a bearer API key in the `Authorization`\nheader. Read-only endpoints accept any active key; write endpoints\n(POST/PUT/PATCH/DELETE) require a key with the `read_write` scope.\n\nKeys can be generated in the dashboard under\n`/users/api-keys`.\n","title":"DevSnorte Community API","version":"1.0.0"},"openapi":"3.0.0","paths":{"/api/v1/categorias":{"get":{"callbacks":{},"deprecated":false,"operationId":"Categorias.index","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoriaListResponse"}}},"description":"All categories"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"List categories with their approved-project count","tags":["Categorias"]}},"/api/v1/eventos":{"get":{"callbacks":{},"deprecated":false,"description":"Lists approved projects in the \"eventos\" category whose event hasn't ended yet, soonest first.","operationId":"Eventos.index","parameters":[{"in":"query","name":"limit","schema":{"maximum":50,"minimum":1,"type":"integer"}},{"description":"Restrict to eventos starting within this many days from today.","in":"query","name":"days","schema":{"minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventoListResponse"}}},"description":"A list of upcoming eventos"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"List upcoming eventos","tags":["Eventos"]}},"/api/v1/me":{"get":{"callbacks":{},"deprecated":false,"description":"Validates the bearer token and returns the owning user plus the key's scope.","operationId":"Me.show","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeResponse"}}},"description":"The authenticated user and key scope"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authentication failed."}},"summary":"Show the calling user and key scope","tags":["Me"]}},"/api/v1/projects":{"get":{"callbacks":{},"deprecated":false,"description":"Lists approved projects, with the same filters as the public UI. Pass `mine=true` to list the caller's own projects (including drafts / pending).","operationId":"Projects.index","parameters":[{"in":"query","name":"page","schema":{"minimum":1,"type":"integer"}},{"in":"query","name":"per_page","schema":{"maximum":100,"minimum":1,"type":"integer"}},{"in":"query","name":"category_id","schema":{"type":"integer"}},{"in":"query","name":"category_slug","schema":{"type":"string"}},{"in":"query","name":"tag","schema":{"type":"string"}},{"in":"query","name":"search","schema":{"type":"string"}},{"in":"query","name":"sort","schema":{"enum":["votes"],"type":"string"}},{"in":"query","name":"mine","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectListResponse"}}},"description":"A page of projects"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authentication failed."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"List projects","tags":["Projects"]},"post":{"callbacks":{},"deprecated":false,"operationId":"Projects.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}},"description":"Created project"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authentication failed."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key does not have write access."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Request body exceeds the 100 KB limit."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"Create a project","tags":["Projects"]}},"/api/v1/projects/{id}":{"delete":{"callbacks":{},"deprecated":false,"operationId":"Projects.delete","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"204":{"description":"No content"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authentication failed."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key does not have write access."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Project not found or not owned by the caller."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"Delete a project you own","tags":["Projects"]},"get":{"callbacks":{},"deprecated":false,"operationId":"Projects.show","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}},"description":"Project"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authentication failed."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Project not found or not visible to the caller."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"Show a project","tags":["Projects"]},"patch":{"callbacks":{},"deprecated":false,"operationId":"Projects.update (2)","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}},"description":"Updated project"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authentication failed."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key does not have write access."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Project not found or not owned by the caller."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Request body exceeds the 100 KB limit."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"Update a project you own","tags":["Projects"]},"put":{"callbacks":{},"deprecated":false,"operationId":"Projects.update","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}},"description":"Updated project"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authentication failed."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key does not have write access."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Project not found or not owned by the caller."},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Request body exceeds the 100 KB limit."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Validation failed."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"Update a project you own","tags":["Projects"]}},"/api/v1/projects/{id}/submit":{"post":{"callbacks":{},"deprecated":false,"description":"Moves a project you own from `draft`/`rejected` into the moderation queue (`pending_review`), or straight to `approved` if you're a trusted user. Reuses the same review flow as the dashboard's \"submit\"/\"resubmit\" buttons.","operationId":"Projects.submit","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectResponse"}}},"description":"Submitted project"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Authentication failed."},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"The API key does not have write access."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Project not found or not owned by the caller."},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Project is not a draft or rejected project."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"Submit a draft or rejected project for review","tags":["Projects"]}},"/api/v1/projetos":{"get":{"callbacks":{},"deprecated":false,"operationId":"Projetos.index","parameters":[{"in":"query","name":"q","schema":{"type":"string"}},{"in":"query","name":"categoria","schema":{"type":"string"}},{"in":"query","name":"tag","schema":{"type":"string"}},{"in":"query","name":"page","schema":{"minimum":1,"type":"integer"}},{"in":"query","name":"per_page","schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjetoListResponse"}}},"description":"A page of approved projects"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"List approved projects","tags":["Projetos"]}},"/api/v1/projetos/{slug}":{"get":{"callbacks":{},"deprecated":false,"description":"`:slug` is the URL slug from `canonical_url`/the `slug` field in list responses (e.g. `minha-api-42`), or the bare project id.","operationId":"Projetos.show","parameters":[{"in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjetoResponse"}}},"description":"Projeto"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Project not found or not approved."},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"description":"Rate limit exceeded. The response includes a `Retry-After` header (seconds).","headers":{"retry-after":{"description":"Number of seconds the caller should wait before retrying.","schema":{"type":"integer"},"style":"simple"}}}},"summary":"Show an approved project by slug","tags":["Projetos"]}}},"security":[{"bearer":[]}],"servers":[{"url":"https://comunidade.devsnorte.com","variables":{}}],"tags":[]}