[NOTE] Github API v4 - GraphQL

[huming0618]

links

• API V4 Document
• Endpoints
  • for github: https://api.github.com/graphql
  • for enterprise site: https://<HOST>/api/graphql
• Explorer
• migrate from rest api

  example

  query

  curl -H "Authorization: bearer token" -X POST -d " \
  { \
  \"query\": \"query { viewer { login }}\" \
  } \
  " https://api.github.com/graphql

  with variable

  query($number_of_repos:Int!) {
  viewer {
  name
   repositories(last: $number_of_repos) {
     nodes {
       name
     }
   }
  }
  }
  variables {
  "number_of_repos": 3
  }

  query and mutation

  
  query FindIssueID {
  repository(owner:"octocat", name:"Hello-World") {
  issue(number:349) {
    id
  }
  }
  }

mutation AddReactionToIssue { addReaction(input:{subjectId:"MDU6SXNzdWUyMzEzOTE1NTE=",content:HOORAY}) { reaction { content } subject { id } } }

[huming0618]

get all branches

{
  repository(owner: "huming0618", name: "learn-rust") {
        refs(first: 100, refPrefix: "refs/heads/") {
          nodes {
            name
            target {
              ... on Commit {
                oid
                committedDate
              }
            }
          }
        }
  }
}

get the commits

{
  repository(name: "learn-rust", owner: "huming0618") {
    object(expression: "master:01-trait") {
      ... on Tree {
        commitUrl
        id
        commitResourcePath
        entries {
          name
          type
        }
      }
    }
  }
}

get entries on branch

  repository(name: "<repo>", owner: "<owner>") {
    object(expression: "master:") {
      ... on Tree {
        entries {
          name
        }
      }
    }
  }

query { 
  repository(name: "<repo>", owner: "<owner>") {
    object(expression: "master:<path>") {
      ... on Blob {
        oid
        byteSize
        text
      }
    }
  }
}

query ListFiles($repoName: String!) {
  repository(name: $repoName) {
    commit(rev: "develop") {
      tree(path: "/", recursive: true) {
        entries {
          path
          isDirectory
          url
        }
      }
    }
  }
}