Módulo de acesso da API APOD da NASA.
npm install @killovsky/nasa![]()
keys como hdurl ou copyright, mas eles são inseridos neste módulo, retornando false por padrão, caso a NASA não tenha. API-KEY. Node.js. data se mal colocada, não sofre erros por usar uma API-KEY inválida e muito mais. bash
npm test
`
$3
- Existem diversas formas de utilizar, mas como se trata de um script que faz uso de Promises, irei dar dois exemplos que funcionam bem, lembrando, você pode rodar sem especificar nada pois também funciona desta forma.
[Clique para exibir] → Descrição de cada parâmetro da execução:
`javascript
// Function especificada
APOD('API_KEY', 'DATA', 'DOWNLOAD', 'LOCAL')
// Function sem especificar
APOD()
/ ---------------------------------
* 1° - API_KEY
* Valores: string
* Padrão: 'DEMO_KEY'
* ---------------------------------
* 2° - DATA
* Valores: string [YYYY-MM-DD]
* Exemplo: 2022-06-27
* Padrão: ''
* ---------------------------------
* 3° - DOWNLOAD
* Valores: boolean [true, false]
* Padrão: false
* ---------------------------------
* 4° - LOCAL
* Valores: string
* Padrão: ''
--------------------------------- /
`
Exemplos de uso:
`javascript
// Usando .then | Modo de uso padrão
const NASA = require('@killovsky/nasa');
NASA.APOD('API-KEY', 'DATA EM YYYY-MM-DD', 'DOWNLOAD', 'LOCAL').then(data => {
// Faça seu código baseado na object 'data' aqui
// Exemplo: console.log(data);
})
// Usando await [async] | Modo de uso padrão
const NASA = require('@killovsky/nasa');
const data = await NASA.APOD('API-KEY', 'DATA EM YYYY-MM-DD', 'DOWNLOAD', 'LOCAL');
// Faça seu código aqui usando a const 'data'
// Exemplo: console.log(data);
`
Códigos já prontos [.then]:
`javascript
// Código usando .then [Sem Download]
const NASA = require('@killovsky/nasa');
NASA.APOD('DEMO_KEY', '2022-06-26', false, false).then(data => console.log(data));
// Código usando .then [Com download] [Certifique-se de que a pasta existe]
const NASA = require('@killovsky/nasa');
NASA.APOD('DEMO_KEY', '2022-06-26', true, './images').then(data => console.log(data));
`
Códigos já prontos [async/await]:
`javascript
// Código usando await [Sem Download]
const NASA = require('@killovsky/nasa');
const data = await NASA.APOD('DEMO_KEY', '2022-06-26', false, false);
console.log(data);
// Código usando .then [Com download] [Certifique-se de que a pasta existe]
const NASA = require('@killovsky/nasa');
const data = await NASA.APOD('DEMO_KEY', '2022-06-26', true, './images');
console.log(data);
// Se você não sabe criar uma função async ou ainda não tiver uma, use este código abaixo:
(async () => {
// Cole um dos códigos com await aqui dentro
})();
`
Exemplo de resultado com explicações:
`JSON
{
"key": "String | API-KEY",
"date": "String | Data [YYYY-MM-DD]",
"error": "true | false",
"download": "String / false | Mensagens sobre o download se requisitado",
"dev_msg": "String / false | Códigos de erros enviados pela NASA",
"data_msg": "String / false | Mensagem de Erro [Caso a data não esteja OK]",
"error_msg": "String / false | Mensagem de erro da requisição",
"best_image": "String / false | URL com a melhor imagem/thumb disponível",
"code": "Number | String | Código de erro HTTP",
"explain": {
"code": "Number / String | Código escrito de HTTP",
"why": "String | Explicação do código HTTP"
},
"headers": {
"date": "String | Data escrita da requisição",
"content-type": "String | Tipo de resposta",
"content-length": "Number | Tamanho da resposta",
"x-ratelimit-limit": "Number | Limites de usos da API",
"x-ratelimit-remaining": "Number | Limites de uso restantes",
"Outros": "E alguns outros headers, faça uma requisição para obter todos."
},
"nasa": {
"copyright": "String / false | Copyright da imagem da NASA",
"date": "String / false | Data do dia dos dados da NASA",
"explanation": "String / false | Descrição do evento da NASA",
"hdurl": "String / false | URL com mídia HD do evento",
"thumbnail_url": "String / false | Thumbnail, caso seja um video",
"media_type": "String / false | Tipo de mídia",
"service_version": "String / false | Versão da API",
"title": "String / false | Titulo do evento",
"url": "String / false | URL com mídia padrão do evento"
}
}
`
Exemplo utilizável de resultado:
`JSON
{
"key": "DEMO_KEY",
"date": "2022-06-26",
"error": false,
"download": false,
"dev_msg": false,
"data_msg": false,
"error_msg": false,
"best_image": "https://apod.nasa.gov/apod/image/1712/SpaceXLaunch_Bobchin_5407.jpg",
"code": 200,
"explain": {
"code": "OK",
"why": "The request is OK, this response depends on the HTTP method used."
},
"headers": {
"date": "Sun, 26 Jun 2022 23:20:45 GMT",
"content-type": "application/json",
"content-length": "1207",
"connection": "close",
"vary": "Accept-Encoding",
"x-ratelimit-limit": "2000",
"x-ratelimit-remaining": "1991",
"access-control-allow-origin": "*",
"access-control-expose-headers": "X-RateLimit-Limit, X-RateLimit-Remaining",
"age": "0",
"via": "http/1.1 api-umbrella (ApacheTrafficServer [cMsSf ])",
"x-cache": "MISS",
"strict-transport-security": "max-age=31536000; preload"
},
"nasa": {
"copyright": "Craig Bobchin",
"date": "2017-12-24",
"explanation": "What's happened to the sky? On Friday, the photogenic launch plume from a SpaceX rocket launch created quite a spectacle over parts of southern California and Arizona. Looking at times like a giant space fish, the impressive rocket launch from Vandenberg Air Force Base near Lompoc, California, was so bright because it was backlit by the setting Sun. Lifting off during a minuscule one-second launch window, the Falcon 9 rocket successfully delivered to low Earth orbit ten Iridium NEXT satellites that are part of a developing global communications network. The plume from the first stage is seen on the right, while the soaring upper stage rocket is seen at the apex of the plume toward the left. Several good videos of the launch were taken. The featured image was captured from Orange County, California, in a 2.5 second duration exposure. Gallery: More images of the SpaceX launch",
"hdurl": "https://apod.nasa.gov/apod/image/1712/SpaceXLaunch_Bobchin_5407.jpg",
"thumbnail_url": false,
"media_type": "image",
"service_version": "v1",
"title": "SpaceX Rocket Launch Plume over California",
"url": "https://apod.nasa.gov/apod/image/1712/SpaceXLaunch_Bobchin_960.jpg"
}
}
``