Consultas

O tipo de consulta define as operações do GraphQL que recuperam os dados do servidor.

Neste artigo

Sobre consultas

Cada esquema de GraphQL tem um tipo de raiz para consultas e mutações. O tipo de consulta define as operações do GraphQL que recuperam os dados do servidor.

Para obter mais informações, confira "Realizar chamadas com o GraphQL".

Observação: nas solicitações do GitHub App feitas com tokens de acesso de usuário, você deve usar consultas separadas para problemas e solicitações de pull. Por exemplo, use os filtros is:issue ou is:pull-request e os equivalentes. O uso da conexão search para retornar uma combinação de problemas e solicitações de pull em uma só consulta resultará em um conjunto vazio de nós.

codeOfConduct

Look up a code of conduct by its key.

Argumentos para codeOfConduct

NomeDescrição

key (String!)

The code of conduct's key.

codesOfConduct

Look up a code of conduct by its key.

enterprise

Look up an enterprise by URL slug.

Argumentos para enterprise

NomeDescrição

invitationToken (String)

The enterprise invitation token.

slug (String!)

The enterprise URL slug.

enterpriseAdministratorInvitation

Look up a pending enterprise administrator invitation by invitee, enterprise and role.

Argumentos para enterpriseAdministratorInvitation

NomeDescrição

enterpriseSlug (String!)

The slug of the enterprise the user was invited to join.

role (EnterpriseAdministratorRole!)

The role for the business member invitation.

userLogin (String!)

The login of the user invited to join the business.

enterpriseAdministratorInvitationByToken

Look up a pending enterprise administrator invitation by invitation token.

Argumentos para enterpriseAdministratorInvitationByToken

NomeDescrição

invitationToken (String!)

The invitation token sent with the invitation email.

enterpriseMemberInvitation

Look up a pending enterprise unaffiliated member invitation by invitee and enterprise.

Argumentos para enterpriseMemberInvitation

NomeDescrição

enterpriseSlug (String!)

The slug of the enterprise the user was invited to join.

userLogin (String!)

The login of the user invited to join the business.

enterpriseMemberInvitationByToken

Look up a pending enterprise unaffiliated member invitation by invitation token.

Argumentos para enterpriseMemberInvitationByToken

NomeDescrição

invitationToken (String!)

The invitation token sent with the invitation email.

id

ID of the object.

Tipo: ID!

license

Look up an open source license by its key.

Tipo: License

Argumentos para license

NomeDescrição

key (String!)

The license's downcased SPDX ID.

licenses

Return a list of known open source licenses.

marketplaceCategories

Get alphabetically sorted list of Marketplace categories.

Argumentos para marketplaceCategories

NomeDescrição

excludeEmpty (Boolean)

Exclude categories with no listings.

excludeSubcategories (Boolean)

Returns top level categories only, excluding any subcategories.

includeCategories ([String!])

Return only the specified categories.

marketplaceCategory

Look up a Marketplace category by its slug.

Argumentos para marketplaceCategory

NomeDescrição

slug (String!)

The URL slug of the category.

useTopicAliases (Boolean)

Also check topic aliases for the category slug.

marketplaceListing

Look up a single Marketplace listing.

Argumentos para marketplaceListing

NomeDescrição

slug (String!)

Select the listing that matches this slug. It's the short name of the listing used in its URL.

marketplaceListings

Look up Marketplace listings.

Argumentos para marketplaceListings

NomeDescrição

adminId (ID)

Select listings that can be administered by the specified user.

after (String)

Returns the elements in the list that come after the specified cursor.

allStates (Boolean)

Select listings visible to the viewer even if they are not approved. If omitted or false, only approved listings will be returned.

before (String)

Returns the elements in the list that come before the specified cursor.

categorySlug (String)

Select only listings with the given category.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

organizationId (ID)

Select listings for products owned by the specified organization.

primaryCategoryOnly (Boolean)

Select only listings where the primary category matches the given category slug.

The default value is false.

slugs ([String])

Select the listings with these slugs, if they are visible to the viewer.

useTopicAliases (Boolean)

Also check topic aliases for the category slug.

viewerCanAdmin (Boolean)

Select listings to which user has admin access. If omitted, listings visible to the viewer are returned.

withFreeTrialsOnly (Boolean)

Select only listings that offer a free trial.

The default value is false.

meta

Return information about the GitHub instance.

node

Fetches an object given its ID.

Tipo: Node

Argumentos para node

NomeDescrição

id (ID!)

ID of the object.

nodes

Lookup nodes by a list of IDs.

Tipo: [Node]!

Argumentos para nodes

NomeDescrição

ids ([ID!]!)

The list of node IDs.

organization

Lookup a organization by login.

Argumentos para organization

NomeDescrição

login (String!)

The organization's login.

rateLimit

The client's rate limit information.

Tipo: RateLimit

Argumentos para rateLimit

NomeDescrição

dryRun (Boolean)

If true, calculate the cost for the query without evaluating it.

The default value is false.

relay

Workaround for re-exposing the root query object. (Refer to https://github.com/facebook/relay/issues/112 for more information.).

Tipo: Query!

repository

Lookup a given repository by the owner and repository name.

Argumentos para repository

NomeDescrição

followRenames (Boolean)

Follow repository renames. If disabled, a repository referenced by its old name will return an error.

The default value is true.

name (String!)

The name of the repository.

owner (String!)

The login field of a user or organization.

repositoryOwner

Lookup a repository owner (ie. either a User or an Organization) by login.

Argumentos para repositoryOwner

NomeDescrição

login (String!)

The username to lookup the owner by.

resource

Lookup resource by a URL.

Argumentos para resource

NomeDescrição

url (URI!)

The URL.

Perform a search across resources, returning a maximum of 1,000 results.

Argumentos para search

NomeDescrição

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

query (String!)

The search string to look for. GitHub search syntax is supported. For more information, see "Searching on GitHub," "Understanding the search syntax," and "Sorting search results.".

type (SearchType!)

The types of search items to search within.

securityAdvisories

GitHub Security Advisories.

Argumentos para securityAdvisories

NomeDescrição

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

classifications ([SecurityAdvisoryClassification!])

A list of classifications to filter advisories by.

epssPercentage (Float)

The EPSS percentage to filter advisories by.

epssPercentile (Float)

The EPSS percentile to filter advisories by.

first (Int)

Returns the first n elements from the list.

identifier (SecurityAdvisoryIdentifierFilter)

Filter advisories by identifier, e.g. GHSA or CVE.

last (Int)

Returns the last n elements from the list.

orderBy (SecurityAdvisoryOrder)

Ordering options for the returned topics.

publishedSince (DateTime)

Filter advisories to those published since a time in the past.

updatedSince (DateTime)

Filter advisories to those updated since a time in the past.

securityAdvisory

Fetch a Security Advisory by its GHSA ID.

Argumentos para securityAdvisory

NomeDescrição

ghsaId (String!)

GitHub Security Advisory ID.

securityVulnerabilities

Software Vulnerabilities documented by GitHub Security Advisories.

Argumentos para securityVulnerabilities

NomeDescrição

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

classifications ([SecurityAdvisoryClassification!])

A list of advisory classifications to filter vulnerabilities by.

ecosystem (SecurityAdvisoryEcosystem)

An ecosystem to filter vulnerabilities by.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

orderBy (SecurityVulnerabilityOrder)

Ordering options for the returned topics.

package (String)

A package name to filter vulnerabilities by.

severities ([SecurityAdvisorySeverity!])

A list of severities to filter vulnerabilities by.

sponsorables

Users and organizations who can be sponsored via GitHub Sponsors.

Argumentos para sponsorables

NomeDescrição

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

dependencyEcosystem (SecurityAdvisoryEcosystem)

Optional filter for which dependencies should be checked for sponsorable owners. Only sponsorable owners of dependencies in this ecosystem will be included. Used when onlyDependencies = true.

Upcoming Change on 2022-07-01 UTC Description: dependencyEcosystem will be removed. Use the ecosystem argument instead. Reason: The type is switching from SecurityAdvisoryEcosystem to DependencyGraphEcosystem.

ecosystem (DependencyGraphEcosystem)

Optional filter for which dependencies should be checked for sponsorable owners. Only sponsorable owners of dependencies in this ecosystem will be included. Used when onlyDependencies = true.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

onlyDependencies (Boolean)

Whether only sponsorables who own the viewer's dependencies will be returned. Must be authenticated to use. Can check an organization instead for their dependencies owned by sponsorables by passing orgLoginForDependencies.

The default value is false.

orderBy (SponsorableOrder)

Ordering options for users and organizations returned from the connection.

orgLoginForDependencies (String)

Optional organization username for whose dependencies should be checked. Used when onlyDependencies = true. Omit to check your own dependencies. If you are not an administrator of the organization, only dependencies from its public repositories will be considered.

topic

Look up a topic by name.

Tipo: Topic

Argumentos para topic

NomeDescrição

name (String!)

The topic's name.

user

Lookup a user by login.

Tipo: User

Argumentos para user

NomeDescrição

login (String!)

The user's login.

viewer

The currently authenticated user.

Tipo: User!