Commit 3da9fef0 authored by colinleroy's avatar colinleroy Committed by Evan Read

Fix lack of documentation on how to fetch a snippet's content using API

parent 2b2f9369
---
title: Fix lack of documentation on how to fetch a snippet's content using API
merge_request: 23448
author: Colin Leroy
type: other
...@@ -37,13 +37,13 @@ Parameters: ...@@ -37,13 +37,13 @@ Parameters:
| --------- | ---- | -------- | ----------- | | --------- | ---- | -------- | ----------- |
| `id` | Integer | yes | The ID of a snippet | | `id` | Integer | yes | The ID of a snippet |
``` bash ```bash
curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/snippets/1 curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/snippets/1
``` ```
Example response: Example response:
``` json ```json
{ {
"id": 1, "id": 1,
"title": "test", "title": "test",
...@@ -65,6 +65,30 @@ Example response: ...@@ -65,6 +65,30 @@ Example response:
} }
``` ```
## Single snippet contents
Get a single snippet's raw contents.
```
GET /snippets/:id/raw
```
Parameters:
| Attribute | Type | Required | Description |
| --------- | ---- | -------- | ----------- |
| `id` | Integer | yes | The ID of a snippet |
```bash
curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/snippets/1/raw
```
Example response:
```
Hello World snippet
```
## Create new snippet ## Create new snippet
Creates a new snippet. The user must have permission to create new snippets. Creates a new snippet. The user must have permission to create new snippets.
...@@ -84,7 +108,7 @@ Parameters: ...@@ -84,7 +108,7 @@ Parameters:
| `visibility` | String | no | The snippet's visibility | | `visibility` | String | no | The snippet's visibility |
``` bash ```bash
curl --request POST \ curl --request POST \
--data '{"title": "This is a snippet", "content": "Hello world", "description": "Hello World snippet", "file_name": "test.txt", "visibility": "internal" }' \ --data '{"title": "This is a snippet", "content": "Hello world", "description": "Hello World snippet", "file_name": "test.txt", "visibility": "internal" }' \
--header 'Content-Type: application/json' \ --header 'Content-Type: application/json' \
...@@ -94,7 +118,7 @@ curl --request POST \ ...@@ -94,7 +118,7 @@ curl --request POST \
Example response: Example response:
``` json ```json
{ {
"id": 1, "id": 1,
"title": "This is a snippet", "title": "This is a snippet",
...@@ -136,7 +160,7 @@ Parameters: ...@@ -136,7 +160,7 @@ Parameters:
| `visibility` | String | no | The snippet's visibility | | `visibility` | String | no | The snippet's visibility |
``` bash ```bash
curl --request PUT \ curl --request PUT \
--data '{"title": "foo", "content": "bar"}' \ --data '{"title": "foo", "content": "bar"}' \
--header 'Content-Type: application/json' \ --header 'Content-Type: application/json' \
...@@ -146,7 +170,7 @@ curl --request PUT \ ...@@ -146,7 +170,7 @@ curl --request PUT \
Example response: Example response:
``` json ```json
{ {
"id": 1, "id": 1,
"title": "test", "title": "test",
...@@ -201,13 +225,13 @@ GET /snippets/public ...@@ -201,13 +225,13 @@ GET /snippets/public
| `per_page` | Integer | no | number of snippets to return per page | | `per_page` | Integer | no | number of snippets to return per page |
| `page` | Integer | no | the page to retrieve | | `page` | Integer | no | the page to retrieve |
``` bash ```bash
curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/snippets/public?per_page=2&page=1 curl --header "PRIVATE-TOKEN: 9koXpg98eAheJpvBs5tK" https://gitlab.example.com/api/v4/snippets/public?per_page=2&page=1
``` ```
Example response: Example response:
``` json ```json
[ [
{ {
"author": { "author": {
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment