Uppdatera en server

PATCH /servers/{qualifiedName}

Uppdatera metadata för en server, t.ex. visningsnamn, beskrivning, repo, ikon eller synlighet. Skicka bara de fält som ska ändras.

Autentisering

Se Autentisering (API-nyckel).

Parametrar

Sökväg

Parameter	Typ	Obligatorisk	Beskrivning
`qualifiedName`	`string`	Ja	Serverns kvalificerade namn, t.ex. `namespace/server`. Använd `%2F` för att URL-koda snedstrecket.

Begäranskropp

Alla fält är valfria. Utelämnade fält lämnas oförändrade.

Fält	Typ	Beskrivning
`displayName`	`string`	Visningsnamn
`description`	`string`	Kort beskrivning
`homepage`	`string \\| null`	URL till serverns hemsida
`repositoryUrl`	`string \\| null`	URL till kodrepo
`backlinkUrl`	`string \\| null`	URL för bakåtlänk
`license`	`string \\| null`	Licensidentifierare
`iconUrl`	`string \\| null`	URL till ikon
`unlisted`	`boolean`	`true` döljer servern från publika listor

Svar

`200` Servern uppdaterades

Fält	Typ	Beskrivning
`success`	`boolean`	`true` vid lyckad uppdatering
`namespace`	`string`	Namespace-namn
`server`	`string`	Servernamn inom namespacet

`400` Ogiltig begäran

Fält	Typ	Beskrivning
`error`	`string`	Felmeddelande

`403` Åtkomst nekad

Fält	Typ	Beskrivning
`error`	`string`	Felmeddelande

`404` Servern hittades inte

Fält	Typ	Beskrivning
`error`	`string`	Felmeddelande

Kodexempel

const res = await fetch(
  'https://api.silai.se/servers/myorg%2Fmy-server',
  {
    method: 'PATCH',
    headers: {
      Authorization: 'Bearer YOUR_API_KEY',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      displayName: 'Uppdaterat namn',
      unlisted: false
    })
  }
);

const result = await res.json();
console.log(result.success);